lhwapi-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,41 @@
+# Apifox MCP Server
+
+MCP 服务器，用于获取 Apifox API 文档。
+
+## 安装
+
+```bash
+npm install -g apifox-mcp-server
+```
+
+## 使用方法
+
+### Claude Desktop 配置
+
+```json
+{
+  "mcpServers": {
+    "apifox-api-doc": {
+      "command": "npx",
+      "args": ["-y", "apifox-mcp-server", "--project-id=你的项目ID"],
+      "env": {
+        "APIFOX_ACCESS_TOKEN": "<你的token>"
+      }
+    }
+  }
+}
+```
+
+### 获取 Apifox Access Token
+
+1. 登录 Apifox
+2. 点击头像 → 账号设置 → API 访问令牌
+3. 新建令牌并保存
+
+## 可用工具
+
+- **listProjects** - 获取项目列表
+- **listApis** - 获取指定项目下的 API 列表
+- **getApiDetail** - 获取单个 API 的详细信息
+- **searchApis** - 搜索 API
+- **exportOpenApi** - 导出 OpenAPI/Swagger 格式

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,225 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const APIFOX_BASE_URL = "https://api.apifox.com";
+const args = process.argv.slice(2);
+let projectId;
+for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--project-id" && args[i + 1]) {
+        projectId = args[i + 1];
+    }
+}
+const 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) : undefined,
+    });
+    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;
+}
+const server = new McpServer({
+    name: "lhwapi-mcp-server",
+    version: "1.0.0",
+});
+server.registerTool("listProjects", {
+    description: "获取 Apifox 项目列表",
+    inputSchema: z.object({
+        token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+}, async ({ token: inputToken }) => {
+    const authToken = inputToken || token;
+    if (!authToken) {
+        return {
+            content: [{ type: "text", text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+            isError: true,
+        };
+    }
+    const projects = await fetchApifox("/v1/projects", authToken);
+    const text = projects
+        .map((p) => `项目: ${p.name} (ID: ${p.id})\n描述: ${p.description || "无"}`)
+        .join("\n\n");
+    return {
+        content: [{ type: "text", text: text || "暂无项目" }],
+    };
+});
+server.registerTool("listApis", {
+    description: "获取指定项目下的 API 列表",
+    inputSchema: z.object({
+        projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+        token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+}, async ({ projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+        return {
+            content: [{ type: "text", text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+            isError: true,
+        };
+    }
+    if (!authProjectId) {
+        return {
+            content: [{ type: "text", text: "错误: 请通过 --project-id 参数指定项目 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 || "暂无 API" }],
+    };
+});
+server.registerTool("getApiDetail", {
+    description: "获取单个 API 的详细信息",
+    inputSchema: z.object({
+        apiId: z.string().describe("API ID"),
+        projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+        token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+}, async ({ apiId, projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+        return {
+            content: [{ type: "text", text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+            isError: true,
+        };
+    }
+    if (!authProjectId) {
+        return {
+            content: [{ type: "text", text: "错误: 请通过 --project-id 参数指定项目 ID" }],
+            isError: true,
+        };
+    }
+    const api = await fetchApifox(`/v1/projects/${authProjectId}/apis/${apiId}`, authToken);
+    let detail = `# ${api.name}\n\n`;
+    detail += `**方法**: ${api.method.toUpperCase()}\n`;
+    detail += `**路径**: ${api.path}\n\n`;
+    if (api.description) {
+        detail += `## 描述\n\n${api.description}\n\n`;
+    }
+    if (api.requestParams?.query?.length) {
+        detail += `## Query 参数\n\n`;
+        api.requestParams.query.forEach((param) => {
+            detail += `- ${param.name}: ${param.type || "string"} ${param.required ? "(必填)" : "(可选)"}\n`;
+        });
+        detail += "\n";
+    }
+    if (api.requestBody?.schema) {
+        detail += `## 请求体\n\n\`\`\`json\n${JSON.stringify(api.requestBody.schema, null, 2)}\n\`\`\`\n\n`;
+    }
+    if (api.responseList?.length) {
+        detail += `## 响应\n\n`;
+        api.responseList.forEach((resp) => {
+            detail += `### ${resp.statusCode}\n`;
+            if (resp.responseBodySchema) {
+                detail += `\`\`\`json\n${JSON.stringify(resp.responseBodySchema, null, 2)}\n\`\`\`\n`;
+            }
+        });
+    }
+    return {
+        content: [{ type: "text", text: detail }],
+    };
+});
+server.registerTool("searchApis", {
+    description: "搜索 API",
+    inputSchema: z.object({
+        keyword: z.string().describe("搜索关键词"),
+        projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+        token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+}, async ({ keyword, projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+        return {
+            content: [{ type: "text", text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+            isError: true,
+        };
+    }
+    if (!authProjectId) {
+        return {
+            content: [{ type: "text", text: "错误: 请通过 --project-id 参数指定项目 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 || "未找到匹配的 API" }],
+    };
+});
+server.registerTool("exportOpenApi", {
+    description: "导出 OpenAPI/Swagger 格式数据",
+    inputSchema: z.object({
+        oasVersion: z.string().optional().describe("OpenAPI 版本: 3.0, 3.1, 2.0"),
+        exportFormat: z.string().optional().describe("导出格式: JSON 或 YAML"),
+        projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+        token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+}, async ({ oasVersion, exportFormat, projectId: inputProjectId, token: inputToken }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    if (!authToken) {
+        return {
+            content: [{ type: "text", text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+            isError: true,
+        };
+    }
+    if (!authProjectId) {
+        return {
+            content: [{ type: "text", text: "错误: 请通过 --project-id 参数指定项目 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("警告: 未指定 --project-id 参数");
+    }
+    if (!token) {
+        console.error("警告: 未设置 APIFOX_ACCESS_TOKEN 环境变量");
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "lhwapi-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for API documentation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "lhwapi-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": ["mcp", "api-docs"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,334 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const APIFOX_BASE_URL = "https://api.apifox.com";
+
+const args = process.argv.slice(2);
+let projectId: string | undefined;
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === "--project-id" && args[i + 1]) {
+    projectId = args[i + 1];
+  }
+}
+
+const token = process.env.APIFOX_ACCESS_TOKEN;
+
+interface ApifoxResponse<T> {
+  data: T;
+  message?: string;
+}
+
+interface Project {
+  id: string;
+  name: string;
+  description?: string;
+}
+
+interface ApiDetail {
+  id: string;
+  name: string;
+  path: string;
+  method: string;
+  description?: string;
+  requestParams?: {
+    query?: any[];
+    path?: any[];
+    header?: any[];
+  };
+  requestBody?: {
+    schema?: any;
+  };
+  responseList?: {
+    statusCode: number;
+    responseBodySchema?: any;
+  }[];
+}
+
+async function fetchApifox<T>(endpoint: string, authToken: string, options?: {
+  method?: string;
+  body?: any;
+}): Promise<T> {
+  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) : undefined,
+  });
+
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`Apifox API error: ${response.status} - ${error}`);
+  }
+
+  const data = await response.json() as ApifoxResponse<T>;
+  return data.data;
+}
+
+const server = new McpServer({
+  name: "lhwapi-mcp-server",
+  version: "1.0.0",
+});
+
+server.registerTool(
+  "listProjects",
+  {
+    description: "获取 Apifox 项目列表",
+    inputSchema: z.object({
+      token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+  },
+  async ({ token: inputToken }: { token?: string }) => {
+    const authToken = inputToken || token;
+    if (!authToken) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+        isError: true,
+      };
+    }
+    const projects = await fetchApifox<Project[]>("/v1/projects", authToken);
+    const text = projects
+      .map((p) => `项目: ${p.name} (ID: ${p.id})\n描述: ${p.description || "无"}`)
+      .join("\n\n");
+    return {
+      content: [{ type: "text" as const, text: text || "暂无项目" }],
+    };
+  }
+);
+
+server.registerTool(
+  "listApis",
+  {
+    description: "获取指定项目下的 API 列表",
+    inputSchema: z.object({
+      projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+      token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+  },
+  async ({ projectId: inputProjectId, token: inputToken }: { projectId?: string; token?: string }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    
+    if (!authToken) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+        isError: true,
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请通过 --project-id 参数指定项目 ID" }],
+        isError: true,
+      };
+    }
+    
+    const apis = await fetchApifox<ApiDetail[]>(
+      `/v1/projects/${authProjectId}/apis`,
+      authToken
+    );
+    const text = apis
+      .map((api) => `[${api.method.toUpperCase()}] ${api.path} - ${api.name}`)
+      .join("\n");
+    return {
+      content: [{ type: "text" as const, text: text || "暂无 API" }],
+    };
+  }
+);
+
+server.registerTool(
+  "getApiDetail",
+  {
+    description: "获取单个 API 的详细信息",
+    inputSchema: z.object({
+      apiId: z.string().describe("API ID"),
+      projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+      token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+  },
+  async ({ apiId, projectId: inputProjectId, token: inputToken }: { apiId: string; projectId?: string; token?: string }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    
+    if (!authToken) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+        isError: true,
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请通过 --project-id 参数指定项目 ID" }],
+        isError: true,
+      };
+    }
+    
+    const api = await fetchApifox<ApiDetail>(
+      `/v1/projects/${authProjectId}/apis/${apiId}`,
+      authToken
+    );
+
+    let detail = `# ${api.name}\n\n`;
+    detail += `**方法**: ${api.method.toUpperCase()}\n`;
+    detail += `**路径**: ${api.path}\n\n`;
+    
+    if (api.description) {
+      detail += `## 描述\n\n${api.description}\n\n`;
+    }
+
+    if (api.requestParams?.query?.length) {
+      detail += `## Query 参数\n\n`;
+      api.requestParams.query.forEach((param: any) => {
+        detail += `- ${param.name}: ${param.type || "string"} ${
+          param.required ? "(必填)" : "(可选)"
+        }\n`;
+      });
+      detail += "\n";
+    }
+
+    if (api.requestBody?.schema) {
+      detail += `## 请求体\n\n\`\`\`json\n${JSON.stringify(api.requestBody.schema, null, 2)}\n\`\`\`\n\n`;
+    }
+
+    if (api.responseList?.length) {
+      detail += `## 响应\n\n`;
+      api.responseList.forEach((resp) => {
+        detail += `### ${resp.statusCode}\n`;
+        if (resp.responseBodySchema) {
+          detail += `\`\`\`json\n${JSON.stringify(resp.responseBodySchema, null, 2)}\n\`\`\`\n`;
+        }
+      });
+    }
+
+    return {
+      content: [{ type: "text" as const, text: detail }],
+    };
+  }
+);
+
+server.registerTool(
+  "searchApis",
+  {
+    description: "搜索 API",
+    inputSchema: z.object({
+      keyword: z.string().describe("搜索关键词"),
+      projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+      token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+  },
+  async ({ keyword, projectId: inputProjectId, token: inputToken }: { keyword: string; projectId?: string; token?: string }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    
+    if (!authToken) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+        isError: true,
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请通过 --project-id 参数指定项目 ID" }],
+        isError: true,
+      };
+    }
+    
+    const apis = await fetchApifox<ApiDetail[]>(
+      `/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" as const, text: text || "未找到匹配的 API" }],
+    };
+  }
+);
+
+server.registerTool(
+  "exportOpenApi",
+  {
+    description: "导出 OpenAPI/Swagger 格式数据",
+    inputSchema: z.object({
+      oasVersion: z.string().optional().describe("OpenAPI 版本: 3.0, 3.1, 2.0"),
+      exportFormat: z.string().optional().describe("导出格式: JSON 或 YAML"),
+      projectId: z.string().optional().describe("项目 ID (可选，默认使用命令行参数)"),
+      token: z.string().optional().describe("Apifox 访问令牌 (可选，默认使用环境变量)"),
+    }).shape,
+  },
+  async ({ oasVersion, exportFormat, projectId: inputProjectId, token: inputToken }: { 
+    oasVersion?: string; 
+    exportFormat?: string; 
+    projectId?: string; 
+    token?: string 
+  }) => {
+    const authToken = inputToken || token;
+    const authProjectId = inputProjectId || projectId;
+    
+    if (!authToken) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请设置 APIFOX_ACCESS_TOKEN 环境变量或传入 token 参数" }],
+        isError: true,
+      };
+    }
+    if (!authProjectId) {
+      return {
+        content: [{ type: "text" as const, text: "错误: 请通过 --project-id 参数指定项目 ID" }],
+        isError: true,
+      };
+    }
+    
+    const result = await fetchApifox<any>(
+      `/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: string;
+    if (format.toUpperCase() === "YAML") {
+      output = result.openapi || "";
+    } else {
+      output = JSON.stringify(result, null, 2);
+    }
+
+    return {
+      content: [{ type: "text" as const, text: output }],
+    };
+  }
+);
+
+async function main() {
+  if (!projectId) {
+    console.error("警告: 未指定 --project-id 参数");
+  }
+  if (!token) {
+    console.error("警告: 未设置 APIFOX_ACCESS_TOKEN 环境变量");
+  }
+  
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}