lhwapi-mcp-server 1.0.3 → 1.0.4

package/dist/bundle.js

@@ -0,0 +1,277 @@
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var APIFOX_BASE_URL = "https://api.apifox.com";
+var args = process.argv.slice(2);
+var projectId;
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === "--project-id" && args[i + 1]) {
+    projectId = args[i + 1];
+  }
+}
+var token = process.env.APIFOX_ACCESS_TOKEN;
+async function fetchApifox(endpoint, authToken, options) {
+  const response = await fetch(`${APIFOX_BASE_URL}${endpoint}`, {
+    method: options?.method || "GET",
+    headers: {
+      "Authorization": `Bearer ${authToken}`,
+      "Content-Type": "application/json",
+      "X-Apifox-Api-Version": "2024-03-28"
+    },
+    body: options?.body ? JSON.stringify(options.body) : void 0
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`Apifox API error: ${response.status} - ${error}`);
+  }
+  const data = await response.json();
+  return data.data;
+}
+var server = new McpServer({
+  name: "lhwapi-mcp-server",
+  version: "1.0.0"
+});
+server.registerTool(
+  "listProjects",
+  {
+    description: "\u83B7\u53D6 Apifox \u9879\u76EE\u5217\u8868",
+    inputSchema: z.object({
+      token: z.string().optional().describe("Apifox \u8BBF\u95EE\u4EE4\u724C (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u73AF\u5883\u53D8\u91CF)")
+    }).shape
+  },
+  async ({ token: inputToken }) => {
+    const authToken = inputToken || token;
+    if (!authToken) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u8BBE\u7F6E APIFOX_ACCESS_TOKEN \u73AF\u5883\u53D8\u91CF\u6216\u4F20\u5165 token \u53C2\u6570" }],
+        isError: true
+      };
+    }
+    const projects = await fetchApifox("/v1/projects", authToken);
+    const text = projects.map((p) => `\u9879\u76EE: ${p.name} (ID: ${p.id})
+\u63CF\u8FF0: ${p.description || "\u65E0"}`).join("\n\n");
+    return {
+      content: [{ type: "text", text: text || "\u6682\u65E0\u9879\u76EE" }]
+    };
+  }
+);
+server.registerTool(
+  "listApis",
+  {
+    description: "\u83B7\u53D6\u6307\u5B9A\u9879\u76EE\u4E0B\u7684 API \u5217\u8868",
+    inputSchema: z.object({
+      projectId: z.string().optional().describe("\u9879\u76EE ID (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u547D\u4EE4\u884C\u53C2\u6570)"),
+      token: z.string().optional().describe("Apifox \u8BBF\u95EE\u4EE4\u724C (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u73AF\u5883\u53D8\u91CF)")
+    }).shape
+  },
+  async ({ projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u8BBE\u7F6E APIFOX_ACCESS_TOKEN \u73AF\u5883\u53D8\u91CF\u6216\u4F20\u5165 token \u53C2\u6570" }],
+        isError: true
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u901A\u8FC7 --project-id \u53C2\u6570\u6307\u5B9A\u9879\u76EE ID" }],
+        isError: true
+      };
+    }
+    const apis = await fetchApifox(
+      `/v1/projects/${authProjectId}/apis`,
+      authToken
+    );
+    const text = apis.map((api) => `[${api.method.toUpperCase()}] ${api.path} - ${api.name}`).join("\n");
+    return {
+      content: [{ type: "text", text: text || "\u6682\u65E0 API" }]
+    };
+  }
+);
+server.registerTool(
+  "getApiDetail",
+  {
+    description: "\u83B7\u53D6\u5355\u4E2A API \u7684\u8BE6\u7EC6\u4FE1\u606F",
+    inputSchema: z.object({
+      apiId: z.string().describe("API ID"),
+      projectId: z.string().optional().describe("\u9879\u76EE ID (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u547D\u4EE4\u884C\u53C2\u6570)"),
+      token: z.string().optional().describe("Apifox \u8BBF\u95EE\u4EE4\u724C (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u73AF\u5883\u53D8\u91CF)")
+    }).shape
+  },
+  async ({ apiId, projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u8BBE\u7F6E APIFOX_ACCESS_TOKEN \u73AF\u5883\u53D8\u91CF\u6216\u4F20\u5165 token \u53C2\u6570" }],
+        isError: true
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u901A\u8FC7 --project-id \u53C2\u6570\u6307\u5B9A\u9879\u76EE ID" }],
+        isError: true
+      };
+    }
+    const api = await fetchApifox(
+      `/v1/projects/${authProjectId}/apis/${apiId}`,
+      authToken
+    );
+    let detail = `# ${api.name}
+
+`;
+    detail += `**\u65B9\u6CD5**: ${api.method.toUpperCase()}
+`;
+    detail += `**\u8DEF\u5F84**: ${api.path}
+
+`;
+    if (api.description) {
+      detail += `## \u63CF\u8FF0
+
+${api.description}
+
+`;
+    }
+    if (api.requestParams?.query?.length) {
+      detail += `## Query \u53C2\u6570
+
+`;
+      api.requestParams.query.forEach((param) => {
+        detail += `- ${param.name}: ${param.type || "string"} ${param.required ? "(\u5FC5\u586B)" : "(\u53EF\u9009)"}
+`;
+      });
+      detail += "\n";
+    }
+    if (api.requestBody?.schema) {
+      detail += `## \u8BF7\u6C42\u4F53
+
+\`\`\`json
+${JSON.stringify(api.requestBody.schema, null, 2)}
+\`\`\`
+
+`;
+    }
+    if (api.responseList?.length) {
+      detail += `## \u54CD\u5E94
+
+`;
+      api.responseList.forEach((resp) => {
+        detail += `### ${resp.statusCode}
+`;
+        if (resp.responseBodySchema) {
+          detail += `\`\`\`json
+${JSON.stringify(resp.responseBodySchema, null, 2)}
+\`\`\`
+`;
+        }
+      });
+    }
+    return {
+      content: [{ type: "text", text: detail }]
+    };
+  }
+);
+server.registerTool(
+  "searchApis",
+  {
+    description: "\u641C\u7D22 API",
+    inputSchema: z.object({
+      keyword: z.string().describe("\u641C\u7D22\u5173\u952E\u8BCD"),
+      projectId: z.string().optional().describe("\u9879\u76EE ID (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u547D\u4EE4\u884C\u53C2\u6570)"),
+      token: z.string().optional().describe("Apifox \u8BBF\u95EE\u4EE4\u724C (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u73AF\u5883\u53D8\u91CF)")
+    }).shape
+  },
+  async ({ keyword, projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u8BBE\u7F6E APIFOX_ACCESS_TOKEN \u73AF\u5883\u53D8\u91CF\u6216\u4F20\u5165 token \u53C2\u6570" }],
+        isError: true
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u901A\u8FC7 --project-id \u53C2\u6570\u6307\u5B9A\u9879\u76EE ID" }],
+        isError: true
+      };
+    }
+    const apis = await fetchApifox(
+      `/v1/projects/${authProjectId}/apis`,
+      authToken
+    );
+    const filtered = apis.filter(
+      (api) => api.name.toLowerCase().includes(keyword.toLowerCase()) || api.path.toLowerCase().includes(keyword.toLowerCase())
+    );
+    const text = filtered.map((api) => `[${api.method.toUpperCase()}] ${api.path} - ${api.name}`).join("\n");
+    return {
+      content: [{ type: "text", text: text || "\u672A\u627E\u5230\u5339\u914D\u7684 API" }]
+    };
+  }
+);
+server.registerTool(
+  "exportOpenApi",
+  {
+    description: "\u5BFC\u51FA OpenAPI/Swagger \u683C\u5F0F\u6570\u636E",
+    inputSchema: z.object({
+      oasVersion: z.string().optional().describe("OpenAPI \u7248\u672C: 3.0, 3.1, 2.0"),
+      exportFormat: z.string().optional().describe("\u5BFC\u51FA\u683C\u5F0F: JSON \u6216 YAML"),
+      projectId: z.string().optional().describe("\u9879\u76EE ID (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u547D\u4EE4\u884C\u53C2\u6570)"),
+      token: z.string().optional().describe("Apifox \u8BBF\u95EE\u4EE4\u724C (\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u73AF\u5883\u53D8\u91CF)")
+    }).shape
+  },
+  async ({ oasVersion, exportFormat, projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u8BBE\u7F6E APIFOX_ACCESS_TOKEN \u73AF\u5883\u53D8\u91CF\u6216\u4F20\u5165 token \u53C2\u6570" }],
+        isError: true
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text", text: "\u9519\u8BEF: \u8BF7\u901A\u8FC7 --project-id \u53C2\u6570\u6307\u5B9A\u9879\u76EE ID" }],
+        isError: true
+      };
+    }
+    const result = await fetchApifox(
+      `/v1/projects/${authProjectId}/export-openapi`,
+      authToken,
+      {
+        method: "POST",
+        body: {
+          scope: { type: "ALL" },
+          oasVersion: oasVersion || "3.1",
+          exportFormat: exportFormat || "JSON"
+        }
+      }
+    );
+    const format = exportFormat || "JSON";
+    let output;
+    if (format.toUpperCase() === "YAML") {
+      output = result.openapi || "";
+    } else {
+      output = JSON.stringify(result, null, 2);
+    }
+    return {
+      content: [{ type: "text", text: output }]
+    };
+  }
+);
+async function main() {
+  if (!projectId) {
+    console.error("\u8B66\u544A: \u672A\u6307\u5B9A --project-id \u53C2\u6570");
+  }
+  if (!token) {
+    console.error("\u8B66\u544A: \u672A\u8BBE\u7F6E APIFOX_ACCESS_TOKEN \u73AF\u5883\u53D8\u91CF");
+  }
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/dist/cli.cjs

@@ -3,7 +3,7 @@ const { spawn } = require("child_process");
 const path = require("path");
 
 const args = process.argv.slice(2);
-const child = spawn("node", [path.join(__dirname, "index.js"), ...args], {
+const child = spawn("node", [path.join(__dirname, "bundle.js"), ...args], {
   stdio: "inherit",
   shell: true,
 });

package/package.json

@@ -1,19 +1,23 @@
 {
   "name": "lhwapi-mcp-server",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "MCP server for API documentation",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "lhwapi-mcp-server": "./dist/cli.cjs"
+    "lhwapi-mcp-server": "dist/cli.cjs"
   },
   "scripts": {
     "build": "tsc",
-    "start": "node dist/index.js",
+    "bundle": "node scripts/build.mjs",
+    "start": "node dist/bundle.js",
     "dev": "tsx src/index.ts"
   },
-  "keywords": ["mcp", "api-docs"],
+  "keywords": [
+    "mcp",
+    "api-docs"
+  ],
   "author": "",
   "license": "MIT",
   "dependencies": {
@@ -22,6 +26,7 @@
   },
   "devDependencies": {
     "@types/node": "^25.3.2",
+    "esbuild": "^0.27.3",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }

package/scripts/build.mjs

@@ -0,0 +1,12 @@
+import * as esbuild from 'esbuild';
+
+await esbuild.build({
+  entryPoints: ['src/index.ts'],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  outfile: 'dist/bundle.js',
+  format: 'esm',
+  external: [],
+  packages: 'external',
+});