hono-mcp 1.4.4 → 1.4.7

package/dist/tools/decorator-tools.js

@@ -5,8 +5,11 @@ export const executeCommandTool = (server) => {
         type: z
             .string()
             .describe("Command type (e.g., math.add, math.subtract, math.multiply, math.divide)"),
-        params: z.record(z.any()).describe("Command parameters"),
-    }, async ({ type, params }) => {
+        params: z
+            .record(z.unknown())
+            .optional()
+            .describe("Command parameters (optional for commands without params)"),
+    }, async ({ type, params = {}, }) => {
         console.log("executeCommand called with:", { type, params });
         const command = getCommandRegistry().get(type);
         if (!command) {
@@ -38,51 +41,73 @@ export const executeCommandTool = (server) => {
         return await command.handler(validationResult.data);
     });
 };
+// 从 Zod schema 提取类型名
+function getZodTypeName(schema) {
+    const def = schema._def;
+    if (def.typeName === "ZodOptional") {
+        return getZodTypeName(def.innerType) + "?";
+    }
+    if (def.typeName === "ZodDefault") {
+        return getZodTypeName(def.innerType);
+    }
+    if (def.typeName === "ZodString")
+        return "string";
+    if (def.typeName === "ZodNumber")
+        return "number";
+    if (def.typeName === "ZodBoolean")
+        return "boolean";
+    if (def.typeName === "ZodArray")
+        return "array";
+    if (def.typeName === "ZodObject")
+        return "object";
+    return "any";
+}
+// 生成示例值
+function getExampleValue(schema) {
+    const def = schema._def;
+    if (def.typeName === "ZodOptional" || def.typeName === "ZodDefault") {
+        return undefined; // optional 参数不生成示例
+    }
+    if (def.typeName === "ZodString")
+        return "example";
+    if (def.typeName === "ZodNumber")
+        return 1;
+    if (def.typeName === "ZodBoolean")
+        return true;
+    return null;
+}
 export const helpTool = (server) => {
-    server.tool("help", "Get help information about available commands", {
-        type: {
-            type: "string",
-            description: "Command type to get help for (optional)",
-        },
-    }, async ({ type }) => {
-        if (type) {
-            const command = getCommandRegistry().get(type);
-            if (!command) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Unknown command type: ${type}\n\nAvailable commands:\n${Array.from(getCommandRegistry().keys())
-                                .map((t) => `- ${t}`)
-                                .join("\n")}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const paramsInfo = Array.from(command.params.entries())
-                .map(([key, schema]) => {
-                const description = schema.description || "No description";
-                return `- ${key}: ${description}`;
-            })
-                .join("\n");
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Command: ${command.type}\nDescription: ${command.description}\n\nParameters:\n${paramsInfo}`,
-                    },
-                ],
-            };
-        }
-        const commandList = Array.from(getCommandRegistry().values())
-            .map((cmd) => `- ${cmd.type}: ${cmd.description}`)
-            .join("\n");
+    server.tool("help", "Get help information about available commands", {}, async () => {
+        const commands = Array.from(getCommandRegistry().values());
+        const sections = commands.map((cmd) => {
+            // 构建参数类型字符串
+            const paramEntries = Array.from(cmd.params.entries());
+            const paramsStr = paramEntries.length === 0
+                ? "{}"
+                : "{ " +
+                    paramEntries
+                        .map(([key, schema]) => `${key}: ${getZodTypeName(schema)}`)
+                        .join(", ") +
+                    " }";
+            // 构建示例 params
+            const exampleParams = {};
+            paramEntries.forEach(([key, schema]) => {
+                const val = getExampleValue(schema);
+                if (val !== undefined) {
+                    exampleParams[key] = val;
+                }
+            });
+            const example = JSON.stringify({
+                type: cmd.type,
+                params: exampleParams,
+            });
+            return `### ${cmd.type}\n${cmd.description}\nParams: ${paramsStr}\nExample: ${example}`;
+        });
         return {
             content: [
                 {
                     type: "text",
-                    text: `Available commands:\n${commandList}\n\nUse help with a specific command type for details.`,
+                    text: `## Commands\n\n${sections.join("\n\n")}`,
                 },
             ],
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono-mcp",
-  "version": "1.4.4",
+  "version": "1.4.7",
   "description": "MCP server built with Hono - supports both Vercel deployment and npx CLI usage",
   "main": "dist/index.js",
   "bin": {