transn-yapi-mcp 0.1.0 → 0.1.2

package/dist/index.js

@@ -3,8 +3,8 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { tools } from "./tools.js";
 const server = new McpServer({
-    name: "@transn/yapi-mcp",
-    version: "0.1.0"
+    name: "transn-yapi-mcp",
+    version: "0.1.2"
 });
 // 注册工具
 for (const tool of tools) {
@@ -15,4 +15,8 @@ for (const tool of tools) {
 }
 const transport = new StdioServerTransport();
 await server.connect(transport);
+// 确保在无输入时进程不立即退出，便于被 MCP 客户端保持长连接
+process.stdin.resume();
+// 兜底保活，避免在某些环境下事件循环清空直接退出
+setInterval(() => { }, 1 << 30);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,OAAO;AACP,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;IACzB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,OAAO;AACP,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;IACzB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,kCAAkC;AAClC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;AACvB,0BAA0B;AAC1B,WAAW,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC"}

package/dist/tools.js

@@ -1,8 +1,10 @@
+// src/tools.ts
 import { z } from "zod";
 import { getInterface, getInterfaceByPath } from "./yapi.js";
 export const tools = [
     {
-        name: "yapi.get_api_context",
+        // 工具名用简单下划线，避免客户端再做转换
+        name: "yapi_get_api_context",
         description: "Get structured API context from YAPI",
         inputSchema: z.object({
             projectId: z.number().optional(),
@@ -12,7 +14,7 @@ export const tools = [
             const api = projectId
                 ? await getInterface(projectId, interfaceId)
                 : await getInterface(interfaceId);
-            return {
+            const payload = {
                 name: api.title,
                 path: api.path,
                 method: api.method,
@@ -23,10 +25,19 @@ export const tools = [
                 },
                 response: api.res_body
             };
+            // ★ 关键：返回 MCP 标准的 CallToolResult
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(payload) // 先用 text，保证协议合法
+                    }
+                ]
+            };
         }
     },
     {
-        name: "yapi.get_api_context_by_path",
+        name: "yapi_get_api_context_by_path",
         description: "Get API context by path within a YAPI project",
         inputSchema: z.object({
             projectId: z.number(),
@@ -35,7 +46,7 @@ export const tools = [
         }),
         handler: async ({ projectId, path, method }) => {
             const api = await getInterfaceByPath(projectId, path, method);
-            return {
+            const payload = {
                 name: api.title,
                 path: api.path,
                 method: api.method,
@@ -46,6 +57,14 @@ export const tools = [
                 },
                 response: api.res_body
             };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(payload)
+                    }
+                ]
+            };
         }
     }
 ];

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;SACxB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,WAAW,EAA+C,EAAE,EAAE;YACzF,MAAM,GAAG,GAAG,SAAS;gBACnB,CAAC,CAAC,MAAM,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC;gBAC5C,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YAEpC,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,KAAK;gBACf,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,WAAW,EAAE,GAAG,CAAC,IAAI;gBACrB,OAAO,EAAE;oBACP,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,cAAc;iBACzB;gBACD,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC;QACF,OAAO,EAAE,KAAK,EACZ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAwD,EACjF,EAAE;YACF,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAE9D,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,KAAK;gBACf,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,WAAW,EAAE,GAAG,CAAC,IAAI;gBACrB,OAAO,EAAE;oBACP,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,cAAc;iBACzB;gBACD,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;QACE,sBAAsB;QACtB,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;SACxB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,WAAW,EAA+C,EAAE,EAAE;YACzF,MAAM,GAAG,GAAG,SAAS;gBACnB,CAAC,CAAC,MAAM,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC;gBAC5C,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YAEpC,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,GAAG,CAAC,KAAK;gBACf,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,WAAW,EAAE,GAAG,CAAC,IAAI;gBACrB,OAAO,EAAE;oBACP,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,cAAc;iBACzB;gBACD,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC;YAEF,iCAAiC;YACjC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,iBAAiB;qBAChD;iBACF;aACF,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC;QACF,OAAO,EAAE,KAAK,EACZ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAwD,EACjF,EAAE;YACF,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAE9D,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,GAAG,CAAC,KAAK;gBACf,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,WAAW,EAAE,GAAG,CAAC,IAAI;gBACrB,OAAO,EAAE;oBACP,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,cAAc;iBACzB;gBACD,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;qBAC9B;iBACF;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "transn-yapi-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "An MCP server that fetches structured API metadata from YAPI and exposes it as tools.",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -5,7 +5,7 @@ import { tools } from "./tools.js";
 
 const server = new McpServer({
   name: "transn-yapi-mcp",
-  version: "0.1.0"
+  version: "0.1.2"
 });
 
 // 注册工具
@@ -18,3 +18,7 @@ for (const tool of tools) {
 
 const transport = new StdioServerTransport();
 await server.connect(transport);
+// 确保在无输入时进程不立即退出，便于被 MCP 客户端保持长连接
+process.stdin.resume();
+// 兜底保活，避免在某些环境下事件循环清空直接退出
+setInterval(() => {}, 1 << 30);

package/src/tools.ts

@@ -1,9 +1,11 @@
+// src/tools.ts
 import { z } from "zod";
 import { getInterface, getInterfaceByPath } from "./yapi.js";
 
 export const tools = [
   {
-    name: "yapi.get_api_context",
+    // 工具名用简单下划线，避免客户端再做转换
+    name: "yapi_get_api_context",
     description: "Get structured API context from YAPI",
     inputSchema: z.object({
       projectId: z.number().optional(),
@@ -14,7 +16,7 @@ export const tools = [
         ? await getInterface(projectId, interfaceId)
         : await getInterface(interfaceId);
 
-      return {
+      const payload = {
         name: api.title,
         path: api.path,
         method: api.method,
@@ -25,10 +27,20 @@ export const tools = [
         },
         response: api.res_body
       };
+
+      // ★ 关键：返回 MCP 标准的 CallToolResult
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(payload) // 先用 text，保证协议合法
+          }
+        ]
+      };
     }
   },
   {
-    name: "yapi.get_api_context_by_path",
+    name: "yapi_get_api_context_by_path",
     description: "Get API context by path within a YAPI project",
     inputSchema: z.object({
       projectId: z.number(),
@@ -40,7 +52,7 @@ export const tools = [
     ) => {
       const api = await getInterfaceByPath(projectId, path, method);
 
-      return {
+      const payload = {
         name: api.title,
         path: api.path,
         method: api.method,
@@ -51,6 +63,15 @@ export const tools = [
         },
         response: api.res_body
       };
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(payload)
+          }
+        ]
+      };
     }
   }
-];
+];