apifox-workspace-mcp 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/LICENSE +22 -0
  3. package/README.md +380 -0
  4. package/config/apifox-mcp.json.example +5 -0
  5. package/dist/__tests__/logger.test.d.ts +2 -0
  6. package/dist/__tests__/logger.test.d.ts.map +1 -0
  7. package/dist/__tests__/logger.test.js +42 -0
  8. package/dist/__tests__/logger.test.js.map +1 -0
  9. package/dist/__tests__/types.test.d.ts +2 -0
  10. package/dist/__tests__/types.test.d.ts.map +1 -0
  11. package/dist/__tests__/types.test.js +30 -0
  12. package/dist/__tests__/types.test.js.map +1 -0
  13. package/dist/__tests__/url-parser.test.d.ts +2 -0
  14. package/dist/__tests__/url-parser.test.d.ts.map +1 -0
  15. package/dist/__tests__/url-parser.test.js +27 -0
  16. package/dist/__tests__/url-parser.test.js.map +1 -0
  17. package/dist/core/client/apifox.d.ts +62 -0
  18. package/dist/core/client/apifox.d.ts.map +1 -0
  19. package/dist/core/client/apifox.js +87 -0
  20. package/dist/core/client/apifox.js.map +1 -0
  21. package/dist/core/client/index.d.ts +6 -0
  22. package/dist/core/client/index.d.ts.map +1 -0
  23. package/dist/core/client/index.js +6 -0
  24. package/dist/core/client/index.js.map +1 -0
  25. package/dist/core/client/mcp-bridge.d.ts +55 -0
  26. package/dist/core/client/mcp-bridge.d.ts.map +1 -0
  27. package/dist/core/client/mcp-bridge.js +345 -0
  28. package/dist/core/client/mcp-bridge.js.map +1 -0
  29. package/dist/core/config/index.d.ts +5 -0
  30. package/dist/core/config/index.d.ts.map +1 -0
  31. package/dist/core/config/index.js +5 -0
  32. package/dist/core/config/index.js.map +1 -0
  33. package/dist/core/config/manager.d.ts +132 -0
  34. package/dist/core/config/manager.d.ts.map +1 -0
  35. package/dist/core/config/manager.js +298 -0
  36. package/dist/core/config/manager.js.map +1 -0
  37. package/dist/core/context-store.d.ts +46 -0
  38. package/dist/core/context-store.d.ts.map +1 -0
  39. package/dist/core/context-store.js +82 -0
  40. package/dist/core/context-store.js.map +1 -0
  41. package/dist/core/generator/artifact.d.ts +20 -0
  42. package/dist/core/generator/artifact.d.ts.map +1 -0
  43. package/dist/core/generator/artifact.js +127 -0
  44. package/dist/core/generator/artifact.js.map +1 -0
  45. package/dist/core/generator/index.d.ts +6 -0
  46. package/dist/core/generator/index.d.ts.map +1 -0
  47. package/dist/core/generator/index.js +5 -0
  48. package/dist/core/generator/index.js.map +1 -0
  49. package/dist/core/index.d.ts +11 -0
  50. package/dist/core/index.d.ts.map +1 -0
  51. package/dist/core/index.js +16 -0
  52. package/dist/core/index.js.map +1 -0
  53. package/dist/core/intent.d.ts +14 -0
  54. package/dist/core/intent.d.ts.map +1 -0
  55. package/dist/core/intent.js +80 -0
  56. package/dist/core/intent.js.map +1 -0
  57. package/dist/core/parser/index.d.ts +6 -0
  58. package/dist/core/parser/index.d.ts.map +1 -0
  59. package/dist/core/parser/index.js +5 -0
  60. package/dist/core/parser/index.js.map +1 -0
  61. package/dist/core/parser/url.d.ts +76 -0
  62. package/dist/core/parser/url.d.ts.map +1 -0
  63. package/dist/core/parser/url.js +232 -0
  64. package/dist/core/parser/url.js.map +1 -0
  65. package/dist/lib/env.d.ts +17 -0
  66. package/dist/lib/env.d.ts.map +1 -0
  67. package/dist/lib/env.js +98 -0
  68. package/dist/lib/env.js.map +1 -0
  69. package/dist/lib/errors.d.ts +39 -0
  70. package/dist/lib/errors.d.ts.map +1 -0
  71. package/dist/lib/errors.js +59 -0
  72. package/dist/lib/errors.js.map +1 -0
  73. package/dist/lib/index.d.ts +9 -0
  74. package/dist/lib/index.d.ts.map +1 -0
  75. package/dist/lib/index.js +12 -0
  76. package/dist/lib/index.js.map +1 -0
  77. package/dist/lib/logger.d.ts +27 -0
  78. package/dist/lib/logger.d.ts.map +1 -0
  79. package/dist/lib/logger.js +79 -0
  80. package/dist/lib/logger.js.map +1 -0
  81. package/dist/lib/project-root.d.ts +8 -0
  82. package/dist/lib/project-root.d.ts.map +1 -0
  83. package/dist/lib/project-root.js +46 -0
  84. package/dist/lib/project-root.js.map +1 -0
  85. package/dist/server/handlers/assistant.d.ts +20 -0
  86. package/dist/server/handlers/assistant.d.ts.map +1 -0
  87. package/dist/server/handlers/assistant.js +71 -0
  88. package/dist/server/handlers/assistant.js.map +1 -0
  89. package/dist/server/handlers/generate-artifacts.d.ts +31 -0
  90. package/dist/server/handlers/generate-artifacts.d.ts.map +1 -0
  91. package/dist/server/handlers/generate-artifacts.js +75 -0
  92. package/dist/server/handlers/generate-artifacts.js.map +1 -0
  93. package/dist/server/handlers/get-interface-detail.d.ts +28 -0
  94. package/dist/server/handlers/get-interface-detail.d.ts.map +1 -0
  95. package/dist/server/handlers/get-interface-detail.js +59 -0
  96. package/dist/server/handlers/get-interface-detail.js.map +1 -0
  97. package/dist/server/handlers/index.d.ts +11 -0
  98. package/dist/server/handlers/index.d.ts.map +1 -0
  99. package/dist/server/handlers/index.js +13 -0
  100. package/dist/server/handlers/index.js.map +1 -0
  101. package/dist/server/handlers/list-projects.d.ts +12 -0
  102. package/dist/server/handlers/list-projects.d.ts.map +1 -0
  103. package/dist/server/handlers/list-projects.js +37 -0
  104. package/dist/server/handlers/list-projects.js.map +1 -0
  105. package/dist/server/handlers/parse-and-add-project.d.ts +28 -0
  106. package/dist/server/handlers/parse-and-add-project.d.ts.map +1 -0
  107. package/dist/server/handlers/parse-and-add-project.js +224 -0
  108. package/dist/server/handlers/parse-and-add-project.js.map +1 -0
  109. package/dist/server/handlers/query-interfaces.d.ts +30 -0
  110. package/dist/server/handlers/query-interfaces.d.ts.map +1 -0
  111. package/dist/server/handlers/query-interfaces.js +67 -0
  112. package/dist/server/handlers/query-interfaces.js.map +1 -0
  113. package/dist/server/handlers/utils.d.ts +51 -0
  114. package/dist/server/handlers/utils.d.ts.map +1 -0
  115. package/dist/server/handlers/utils.js +79 -0
  116. package/dist/server/handlers/utils.js.map +1 -0
  117. package/dist/server/index.d.ts +3 -0
  118. package/dist/server/index.d.ts.map +1 -0
  119. package/dist/server/index.js +248 -0
  120. package/dist/server/index.js.map +1 -0
  121. package/dist/types/index.d.ts +119 -0
  122. package/dist/types/index.d.ts.map +1 -0
  123. package/dist/types/index.js +19 -0
  124. package/dist/types/index.js.map +1 -0
  125. package/package.json +78 -0
@@ -0,0 +1,67 @@
1
+ import { resolveProjectInfo, buildTextResponse, buildMissingTokenResponse } from './utils.js';
2
+ /**
3
+ * 处理查询接口请求
4
+ */
5
+ export async function handleQueryInterfaces(args, ctx) {
6
+ const { keyword, tag, limit } = args;
7
+ const { configManager, mcpBridge, contextStore } = ctx;
8
+ const projectInfo = resolveProjectInfo(configManager, contextStore, args.projectName, args.projectId);
9
+ if (!projectInfo) {
10
+ return buildTextResponse('暂时不知道要查询哪个项目,可以先告诉我项目名称,或运行 parse_and_add_project 解析分享链接。');
11
+ }
12
+ const accessToken = configManager.getAccessToken();
13
+ if (!accessToken) {
14
+ return buildMissingTokenResponse();
15
+ }
16
+ try {
17
+ const interfaces = await mcpBridge.getInterfacesViaMcp(accessToken, projectInfo.projectId, keyword);
18
+ const filtered = interfaces.filter((api) => {
19
+ if (!tag) {
20
+ return true;
21
+ }
22
+ const target = `${api.name} ${api.description ?? ''}`.toLowerCase();
23
+ return target.includes(tag.toLowerCase());
24
+ });
25
+ if (filtered.length === 0) {
26
+ return buildTextResponse(tag
27
+ ? `没有找到包含 "${tag}" 的接口,你可以换个关键词再试试。`
28
+ : `没有找到匹配 "${keyword ?? '全部'}" 的接口。`);
29
+ }
30
+ const limited = filtered.slice(0, limit ?? 20);
31
+ const rows = limited
32
+ .map((api, index) => `${index + 1}. **${api.name}** · ${api.method} \`${api.path}\`\n ID: ${api.id}\n 摘要: ${api.description || '暂无描述'}`)
33
+ .join('\n\n');
34
+ const summaryList = limited.map((api) => ({
35
+ id: String(api.id),
36
+ name: api.name,
37
+ method: api.method,
38
+ path: api.path,
39
+ description: api.description,
40
+ }));
41
+ contextStore.setLastProject(projectInfo.projectName, projectInfo.projectId);
42
+ contextStore.saveInterfaceList(projectInfo.projectName, projectInfo.projectId, summaryList);
43
+ const hint = limited.length > 0
44
+ ? `想看详情可以直接说"告诉我 ${limited[0].name} 的接口细节",或者试试"帮我生成 ${limited[0].name} 的类型"。`
45
+ : '';
46
+ return {
47
+ content: [
48
+ {
49
+ type: 'text',
50
+ text: `找到 ${filtered.length} 个接口,显示前 ${limited.length} 个:\n\n${rows}\n\n${hint}`,
51
+ },
52
+ ],
53
+ };
54
+ }
55
+ catch (error) {
56
+ return {
57
+ content: [
58
+ {
59
+ type: 'text',
60
+ text: `获取接口列表失败: ${error instanceof Error ? error.message : String(error)}`,
61
+ },
62
+ ],
63
+ isError: true,
64
+ };
65
+ }
66
+ }
67
+ //# sourceMappingURL=query-interfaces.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-interfaces.js","sourceRoot":"","sources":["../../../src/server/handlers/query-interfaces.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,51 @@
1
+ import { ConfigManager, ContextStore } from '../../core/index.js';
2
+ /**
3
+ * 项目信息
4
+ */
5
+ export interface ResolvedProjectInfo {
6
+ projectId: string;
7
+ projectName: string;
8
+ }
9
+ /**
10
+ * 解析项目信息
11
+ */
12
+ export declare function resolveProjectInfo(configManager: ConfigManager, contextStore: ContextStore, projectName?: string, projectId?: string): ResolvedProjectInfo | null;
13
+ /**
14
+ * 获取 API Base URL
15
+ */
16
+ export declare function getApiBaseUrlFromEnv(): string | null;
17
+ /**
18
+ * 构建缺失 Token 的响应
19
+ */
20
+ export declare function buildMissingTokenResponse(): {
21
+ content: {
22
+ type: "text";
23
+ text: string;
24
+ }[];
25
+ isError: boolean;
26
+ };
27
+ /**
28
+ * 构建文本响应
29
+ */
30
+ export declare function buildTextResponse(text: string, isError?: boolean): {
31
+ content: {
32
+ type: "text";
33
+ text: string;
34
+ }[];
35
+ isError: boolean;
36
+ };
37
+ /**
38
+ * 构建 curl 代码片段
39
+ */
40
+ export declare function buildCurlSnippet(detail: {
41
+ method?: string;
42
+ path?: string;
43
+ }): string;
44
+ /**
45
+ * 构建 fetch 代码片段
46
+ */
47
+ export declare function buildFetchSnippet(detail: {
48
+ method?: string;
49
+ path?: string;
50
+ }): string;
51
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,mBAAmB,GAAG,IAAI,CAe5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAOpD;AAED;;GAEG;AACH,wBAAgB,yBAAyB;;;;;;EAYxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ;;;;;;EAU9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQpF"}
@@ -0,0 +1,79 @@
1
+ /**
2
+ * 解析项目信息
3
+ */
4
+ export function resolveProjectInfo(configManager, contextStore, projectName, projectId) {
5
+ if (projectId) {
6
+ const derivedName = projectName ?? configManager.getProjectName(projectId) ?? projectId;
7
+ return { projectId, projectName: derivedName };
8
+ }
9
+ if (projectName) {
10
+ const resolvedId = configManager.getProjectId(projectName);
11
+ if (!resolvedId) {
12
+ return null;
13
+ }
14
+ return { projectId: resolvedId, projectName };
15
+ }
16
+ return contextStore.getLastProject();
17
+ }
18
+ /**
19
+ * 获取 API Base URL
20
+ */
21
+ export function getApiBaseUrlFromEnv() {
22
+ const baseUrl = process.env.APIFOX_API_BASE_URL;
23
+ if (!baseUrl) {
24
+ return null;
25
+ }
26
+ const trimmed = baseUrl.trim();
27
+ return trimmed.length > 0 ? trimmed : null;
28
+ }
29
+ /**
30
+ * 构建缺失 Token 的响应
31
+ */
32
+ export function buildMissingTokenResponse() {
33
+ return {
34
+ content: [
35
+ {
36
+ type: 'text',
37
+ text: `需要 APIFOX_ACCESS_TOKEN 才能访问接口信息。\n` +
38
+ `请在 ~/.cursor/mcp.json 或项目 .cursor/mcp.json 的 env 中设置 APIFOX_ACCESS_TOKEN。`,
39
+ },
40
+ ],
41
+ isError: true,
42
+ };
43
+ }
44
+ /**
45
+ * 构建文本响应
46
+ */
47
+ export function buildTextResponse(text, isError = false) {
48
+ return {
49
+ content: [
50
+ {
51
+ type: 'text',
52
+ text,
53
+ },
54
+ ],
55
+ isError,
56
+ };
57
+ }
58
+ /**
59
+ * 构建 curl 代码片段
60
+ */
61
+ export function buildCurlSnippet(detail) {
62
+ const baseUrl = process.env.APIFOX_BASE_URL || 'https://api.example.com';
63
+ return `curl -X ${detail.method || 'GET'} "${baseUrl}${detail.path || '/path'}" \\
64
+ -H "Content-Type: application/json" \\
65
+ -d '{ /* 请求体 */ }'`;
66
+ }
67
+ /**
68
+ * 构建 fetch 代码片段
69
+ */
70
+ export function buildFetchSnippet(detail) {
71
+ const baseUrl = process.env.APIFOX_BASE_URL || 'https://api.example.com';
72
+ return `const response = await fetch('${baseUrl}${detail.path || '/path'}', {
73
+ method: '${detail.method || 'GET'}',
74
+ headers: { 'Content-Type': 'application/json' },
75
+ body: JSON.stringify({ /* 请求体 */ }),
76
+ });
77
+ const data = await response.json();`;
78
+ }
79
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/server/handlers/utils.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAA4B,EAC5B,YAA0B,EAC1B,WAAoB,EACpB,SAAkB;IAElB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,WAAW,GAAG,WAAW,IAAI,aAAa,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;QACxF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,YAAY,CAAC,cAAc,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,oCAAoC;oBACpC,2EAA2E;aAC9E;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IAC7D,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI;aACL;SACF;QACD,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA0C;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,yBAAyB,CAAC;IACzE,OAAO,WAAW,MAAM,CAAC,MAAM,IAAI,KAAK,KAAK,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO;;qBAE1D,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA0C;IAC1E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,yBAAyB,CAAC;IACzE,OAAO,iCAAiC,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO;aAC7D,MAAM,CAAC,MAAM,IAAI,KAAK;;;;oCAIC,CAAC;AACrC,CAAC"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":""}
@@ -0,0 +1,248 @@
1
+ #!/usr/bin/env node
2
+ import { resolve } from 'path';
3
+ import { cwd } from 'process';
4
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
5
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
6
+ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
7
+ import { ConfigManager, McpBridge, ContextStore } from '../core/index.js';
8
+ import { loadEnvFromMcpConfig, DEFAULT_SERVER_NAME, findProjectRoot } from '../lib/index.js';
9
+ import { handleListProjects, handleParseAndAddProject, handleQueryInterfaces, handleGetInterfaceDetail, handleGenerateArtifacts, handleAssistant, getApiBaseUrlFromEnv, } from './handlers/index.js';
10
+ /**
11
+ * Apifox Workspace MCP Server 主入口
12
+ * 提供工作空间级别的 Apifox 项目管理功能
13
+ */
14
+ class ApifoxMcpServer {
15
+ server;
16
+ configManager;
17
+ mcpBridge;
18
+ projectRoot;
19
+ contextStore;
20
+ constructor(projectRoot) {
21
+ // 如果没有指定项目根目录,自动查找
22
+ this.projectRoot = resolve(projectRoot ?? findProjectRoot());
23
+ loadEnvFromMcpConfig({
24
+ projectRoot: this.projectRoot,
25
+ serverName: process.env.APIFOX_WORKSPACE_MCP_NAME ?? DEFAULT_SERVER_NAME,
26
+ });
27
+ this.server = new Server({
28
+ name: 'apifox-workspace-mcp',
29
+ version: '1.0.0',
30
+ }, {
31
+ capabilities: {
32
+ tools: {},
33
+ resources: {},
34
+ },
35
+ });
36
+ this.configManager = new ConfigManager(this.projectRoot);
37
+ this.mcpBridge = new McpBridge();
38
+ this.contextStore = new ContextStore(this.projectRoot);
39
+ // 初始化配置文件
40
+ this.initializeConfig();
41
+ this.setupHandlers();
42
+ }
43
+ /**
44
+ * 初始化配置文件
45
+ */
46
+ initializeConfig() {
47
+ console.error(`🔍 初始化配置文件...`);
48
+ console.error(`📂 当前工作目录: ${cwd()}`);
49
+ console.error(`📂 项目根目录: ${this.projectRoot}`);
50
+ const result = this.configManager.initializeConfig();
51
+ if (result.apifoxConfigCreated) {
52
+ console.error(`✅ 已创建 apifox-mcp.json 配置文件`);
53
+ console.error(` 位置: ${result.configPath}`);
54
+ }
55
+ else if (result.apifoxConfigExists) {
56
+ console.error(`✅ apifox-mcp.json 配置文件已存在`);
57
+ console.error(` 位置: ${result.configPath}`);
58
+ }
59
+ if (result.errors.length > 0) {
60
+ console.error('⚠️ 配置文件初始化警告:');
61
+ result.errors.forEach((error) => {
62
+ console.error(` - ${error}`);
63
+ });
64
+ console.error(` 项目根目录: ${result.projectRoot}`);
65
+ console.error(` 配置文件路径: ${result.configPath}`);
66
+ }
67
+ }
68
+ setupHandlers() {
69
+ // 列出可用工具
70
+ this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
71
+ tools: [
72
+ {
73
+ name: 'list_projects',
74
+ description: '列出当前项目集成的所有 Apifox 项目',
75
+ inputSchema: {
76
+ type: 'object',
77
+ properties: {},
78
+ },
79
+ },
80
+ {
81
+ name: 'parse_and_add_project',
82
+ description: '解析 Apifox 分享链接并添加到项目配置中',
83
+ inputSchema: {
84
+ type: 'object',
85
+ properties: {
86
+ url: {
87
+ type: 'string',
88
+ description: 'Apifox 分享链接,格式: https://apifox.advai.net/apidoc/shared/{projectId}/api-{interfaceId}',
89
+ },
90
+ },
91
+ required: ['url'],
92
+ },
93
+ },
94
+ {
95
+ name: 'query_interfaces',
96
+ description: '查询指定项目中的接口,支持关键词过滤',
97
+ inputSchema: {
98
+ type: 'object',
99
+ properties: {
100
+ projectName: {
101
+ type: 'string',
102
+ description: '项目名称(从 apifox-mcp.json 中)',
103
+ },
104
+ projectId: {
105
+ type: 'string',
106
+ description: '项目 ID(可选,如果提供了 projectName 则不需要)',
107
+ },
108
+ keyword: {
109
+ type: 'string',
110
+ description: '搜索关键词,用于过滤接口(如"特殊字符规则")',
111
+ },
112
+ tag: {
113
+ type: 'string',
114
+ description: '按标签或模块筛选接口',
115
+ },
116
+ limit: {
117
+ type: 'number',
118
+ description: '限制返回的接口数量,默认 20',
119
+ },
120
+ },
121
+ required: [],
122
+ },
123
+ },
124
+ {
125
+ name: 'get_interface_detail',
126
+ description: '获取指定接口的详细信息',
127
+ inputSchema: {
128
+ type: 'object',
129
+ properties: {
130
+ projectName: {
131
+ type: 'string',
132
+ description: '项目名称',
133
+ },
134
+ interfaceId: {
135
+ type: 'string',
136
+ description: '接口 ID',
137
+ },
138
+ },
139
+ required: ['projectName', 'interfaceId'],
140
+ },
141
+ },
142
+ {
143
+ name: 'generate_artifacts',
144
+ description: '根据接口详情生成类型、Mock、请求封装或测试脚本',
145
+ inputSchema: {
146
+ type: 'object',
147
+ properties: {
148
+ projectName: { type: 'string' },
149
+ projectId: { type: 'string' },
150
+ interfaceIds: {
151
+ type: 'array',
152
+ items: { type: 'string' },
153
+ description: '要生成的接口 ID 列表',
154
+ },
155
+ artifactType: {
156
+ type: 'string',
157
+ enum: ['ts_types', 'mock_data', 'request_wrappers', 'test_scripts'],
158
+ },
159
+ outputPath: {
160
+ type: 'string',
161
+ description: '将结果写入文件的相对路径(可选)',
162
+ },
163
+ inline: {
164
+ type: 'boolean',
165
+ description: '是否直接返回内容(默认 true)',
166
+ },
167
+ },
168
+ required: ['artifactType'],
169
+ },
170
+ },
171
+ {
172
+ name: 'apifox_assistant',
173
+ description: '使用自然语言与 Apifox 助手对话,例如"/apifox 搜索支付接口"',
174
+ inputSchema: {
175
+ type: 'object',
176
+ properties: {
177
+ prompt: {
178
+ type: 'string',
179
+ description: '你的自然语言指令,例如"帮我生成退款接口类型"',
180
+ },
181
+ },
182
+ required: ['prompt'],
183
+ },
184
+ },
185
+ ],
186
+ }));
187
+ // 处理工具调用
188
+ this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
189
+ const { name, arguments: args } = request.params;
190
+ try {
191
+ const handlerContext = {
192
+ projectRoot: this.projectRoot,
193
+ configManager: this.configManager,
194
+ mcpBridge: this.mcpBridge,
195
+ contextStore: this.contextStore,
196
+ getApiBaseUrl: getApiBaseUrlFromEnv,
197
+ };
198
+ switch (name) {
199
+ case 'list_projects':
200
+ return await handleListProjects(this.configManager, this.projectRoot);
201
+ case 'parse_and_add_project':
202
+ return await handleParseAndAddProject(args, handlerContext);
203
+ case 'query_interfaces':
204
+ return await handleQueryInterfaces(args, handlerContext);
205
+ case 'get_interface_detail':
206
+ return await handleGetInterfaceDetail(args, handlerContext);
207
+ case 'generate_artifacts':
208
+ return await handleGenerateArtifacts(args, handlerContext);
209
+ case 'apifox_assistant':
210
+ return await handleAssistant(args, handlerContext);
211
+ default:
212
+ throw new Error(`未知工具: ${name}`);
213
+ }
214
+ }
215
+ catch (error) {
216
+ return {
217
+ content: [
218
+ {
219
+ type: 'text',
220
+ text: `错误: ${error instanceof Error ? error.message : String(error)}`,
221
+ },
222
+ ],
223
+ isError: true,
224
+ };
225
+ }
226
+ });
227
+ // 错误处理
228
+ this.server.onerror = (error) => {
229
+ console.error('[MCP Error]', error);
230
+ };
231
+ process.on('SIGINT', async () => {
232
+ await this.server.close();
233
+ process.exit(0);
234
+ });
235
+ }
236
+ /**
237
+ * 启动服务器
238
+ */
239
+ async start() {
240
+ const transport = new StdioServerTransport();
241
+ await this.server.connect(transport);
242
+ console.error('Apifox Workspace MCP Server 已启动');
243
+ }
244
+ }
245
+ // 启动服务器
246
+ const server = new ApifoxMcpServer();
247
+ server.start().catch(console.error);
248
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,119 @@
1
+ /**
2
+ * 共享类型定义
3
+ */
4
+ /**
5
+ * MCP 工具响应类型
6
+ */
7
+ export interface ToolResponse {
8
+ content: Array<{
9
+ type: 'text';
10
+ text: string;
11
+ }>;
12
+ isError?: boolean;
13
+ }
14
+ /**
15
+ * API 请求参数
16
+ */
17
+ export interface ApiRequestSpec {
18
+ headers?: Record<string, string>;
19
+ query?: Record<string, unknown>;
20
+ body?: {
21
+ type?: string;
22
+ jsonSchema?: JsonSchema;
23
+ json?: unknown;
24
+ example?: unknown;
25
+ };
26
+ path?: Record<string, unknown>;
27
+ }
28
+ /**
29
+ * API 响应规格
30
+ */
31
+ export interface ApiResponseSpec {
32
+ statusCode?: number;
33
+ headers?: Record<string, string>;
34
+ body?: {
35
+ type?: string;
36
+ jsonSchema?: JsonSchema;
37
+ json?: unknown;
38
+ example?: unknown;
39
+ };
40
+ example?: unknown;
41
+ }
42
+ /**
43
+ * JSON Schema 定义
44
+ */
45
+ export interface JsonSchema {
46
+ type?: string;
47
+ properties?: Record<string, JsonSchema>;
48
+ items?: JsonSchema;
49
+ required?: string[];
50
+ description?: string;
51
+ enum?: unknown[];
52
+ format?: string;
53
+ $ref?: string;
54
+ }
55
+ /**
56
+ * 接口详情
57
+ */
58
+ export interface InterfaceDetail {
59
+ id: string;
60
+ name: string;
61
+ method: string;
62
+ path: string;
63
+ description?: string;
64
+ request?: ApiRequestSpec;
65
+ response?: ApiResponseSpec;
66
+ }
67
+ /**
68
+ * MCP Server 配置项
69
+ */
70
+ export interface McpServerItem {
71
+ command: string;
72
+ args?: string[];
73
+ env?: Record<string, string>;
74
+ }
75
+ /**
76
+ * MCP 配置文件格式
77
+ */
78
+ export interface McpConfigFile {
79
+ mcpServers: Record<string, McpServerItem>;
80
+ }
81
+ /**
82
+ * 项目信息
83
+ */
84
+ export interface ProjectInfo {
85
+ name: string;
86
+ id: string;
87
+ description?: string;
88
+ mcpConfig?: McpConfigFile;
89
+ executionSteps?: string[];
90
+ }
91
+ /**
92
+ * Handler 上下文
93
+ */
94
+ export interface HandlerContext {
95
+ projectRoot: string;
96
+ getAccessToken: () => string | null;
97
+ getApiBaseUrl: () => string | null;
98
+ }
99
+ /**
100
+ * 创建文本响应的辅助函数
101
+ */
102
+ export declare function createTextResponse(text: string, isError?: boolean): {
103
+ content: {
104
+ type: "text";
105
+ text: string;
106
+ }[];
107
+ isError: boolean;
108
+ };
109
+ /**
110
+ * 创建错误响应的辅助函数
111
+ */
112
+ export declare function createErrorResponse(message: string): {
113
+ content: {
114
+ type: "text";
115
+ text: string;
116
+ }[];
117
+ isError: boolean;
118
+ };
119
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * 共享类型定义
3
+ */
4
+ /**
5
+ * 创建文本响应的辅助函数
6
+ */
7
+ export function createTextResponse(text, isError = false) {
8
+ return {
9
+ content: [{ type: 'text', text }],
10
+ isError,
11
+ };
12
+ }
13
+ /**
14
+ * 创建错误响应的辅助函数
15
+ */
16
+ export function createErrorResponse(message) {
17
+ return createTextResponse(message, true);
18
+ }
19
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0GH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IAC9D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}