law-mcp-server 0.1.5 → 0.1.7

package/dist/lawApi.js

@@ -40,7 +40,23 @@ export const fetchLawData = async (lawId, revisionDate) => {
 };
 export const searchLaws = async (keyword) => {
     const base = config.apiBase.endsWith("/") ? config.apiBase : `${config.apiBase}/`;
-    const url = new URL(`lawsearch`, base);
-    url.searchParams.set("keyword", keyword);
-    return request(url.toString());
+    const queryUrl = new URL(`lawsearch`, base);
+    queryUrl.searchParams.set("keyword", keyword);
+    try {
+        return await request(queryUrl.toString());
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes("404")) {
+            const pathUrl = new URL(`lawsearch/${encodeURIComponent(keyword)}`, base);
+            try {
+                return await request(pathUrl.toString());
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new Error(`Law search failed for keyword "${keyword}". Tried query and path styles. Upstream: ${msg}`);
+            }
+        }
+        throw error;
+    }
 };

package/dist/src/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { StdioJsonRpcServer } from "./mcp.js";
-import { tools, resolveTool } from "./tools.js";
+import { tools, resolveTool, usageInstructions } from "./tools.js";
 const server = new StdioJsonRpcServer();
-const serverInfo = { name: "law-mcp-server", version: "0.1.3" };
+const serverInfo = { name: "law-mcp-server", version: "0.1.6" };
 server.register("initialize", async (params) => {
     const payload = (params ?? {});
     const protocolVersion = typeof payload.protocolVersion === "string"
@@ -11,6 +11,7 @@ server.register("initialize", async (params) => {
     return {
         protocolVersion,
         serverInfo,
+        instructions: usageInstructions,
         capabilities: {
             tools: {
                 list: true,

package/dist/src/lawApi.js

@@ -1,6 +1,15 @@
 import { fetch } from "undici";
 import { cache } from "./cache.js";
 import { config } from "./config.js";
+class HttpError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`Request failed ${status}: ${body}`);
+        this.status = status;
+        this.body = body;
+    }
+}
 const withTimeout = async (promise, ms) => {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), ms);
@@ -23,7 +32,7 @@ const request = async (url, context) => {
         if (res.status === 404 && context?.lawId) {
             throw new Error(`Law not found for lawId "${context.lawId}". Use the official LawID (e.g., 平成十五年法律第五十七号 => H15HO57). Upstream: ${body}`);
         }
-        throw new Error(`Request failed ${res.status}: ${body}`);
+        throw new HttpError(res.status, body);
     }
     const data = (await res.json());
     return data;
@@ -47,7 +56,27 @@ export const searchLaws = async (keyword) => {
     const base = config.apiBase.endsWith("/")
         ? config.apiBase
         : `${config.apiBase}/`;
-    const url = new URL(`lawsearch`, base);
-    url.searchParams.set("keyword", keyword);
-    return request(url.toString());
+    const queryUrl = new URL(`lawsearch`, base);
+    queryUrl.searchParams.set("keyword", keyword);
+    try {
+        return await request(queryUrl.toString());
+    }
+    catch (error) {
+        const is404 = error instanceof HttpError && error.status === 404;
+        // Some deployments return 404 for no hits; normalize to empty result.
+        if (is404) {
+            const pathUrl = new URL(`lawsearch/${encodeURIComponent(keyword)}`, base);
+            try {
+                return await request(pathUrl.toString());
+            }
+            catch (err) {
+                const path404 = err instanceof HttpError && err.status === 404;
+                if (path404) {
+                    return { numberOfHits: 0, referencelaw: [] };
+                }
+                throw err;
+            }
+        }
+        throw error;
+    }
 };

package/dist/src/tools.js

@@ -1,5 +1,6 @@
 import { fetchLawData, searchLaws } from "./lawApi.js";
 import { checkConsistency } from "./consistency.js";
+export const usageInstructions = `Usage guidelines:\n\n- To find laws by Japanese name/keyword, call search_laws first. It returns canonical e-Gov LawID values (e.g., 個人情報保護法 -> H15HO57).\n- Always pass the canonical LawID to fetch_law, list_revisions, and check_consistency (lawIds). Do not pass the Japanese title string.\n- fetch_law accepts optional revisionDate when you need a specific revision.\n- check_consistency requires at least one LawID in lawIds. Use search_laws to discover the IDs before calling.\n- summarize_law can take an optional articles array of article numbers to limit the summary.`;
 const requireString = (value, field) => {
     if (typeof value !== "string" || value.trim().length === 0) {
         throw new Error(`Field ${field} is required`);
@@ -14,7 +15,7 @@ const requireArrayOfStrings = (value, field) => {
 };
 const fetchLaw = {
     name: "fetch_law",
-    description: "Fetch a law by LawID and optional revision date",
+    description: "Fetch a law by canonical e-Gov LawID (e.g., H15HO57) and optional revision date. Use search_laws to look up the LawID first.",
     inputSchema: {
         type: "object",
         properties: {
@@ -32,7 +33,7 @@ const fetchLaw = {
 };
 const search = {
     name: "search_laws",
-    description: "Search laws by keyword",
+    description: "Search laws by Japanese keyword/name and return canonical LawID values for use with other tools.",
     inputSchema: {
         type: "object",
         properties: {
@@ -81,7 +82,7 @@ const summarize = {
 };
 const listRevisions = {
     name: "list_revisions",
-    description: "List known revisions for a law if provided by the API",
+    description: "List known revisions for a law (requires canonical LawID from search_laws).",
     inputSchema: {
         type: "object",
         properties: {
@@ -100,7 +101,7 @@ const listRevisions = {
 };
 const check = {
     name: "check_consistency",
-    description: "Check a document against one or more laws",
+    description: "Check a document against one or more laws (lawIds must be canonical LawIDs from search_laws).",
     inputSchema: {
         type: "object",
         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "law-mcp-server",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "description": "MCP server for e-Gov law API consistency checks",
   "files": [