apifox-import-mcp 1.0.0

package/README.md

@@ -0,0 +1,95 @@
+# MCP Apifox Import Server
+
+一个基于 MCP (Model Context Protocol) 的服务器，用于将 OpenAPI 3/Swagger 2 格式数据导入到 Apifox 平台。
+
+## 快速开始
+
+### Claude Desktop 配置
+
+在 `mcp.json` 中添加：
+
+```json
+{
+  "servers": {
+    "apifox-import": {
+      "command": "npx",
+      "args": ["-y", "apifox-import-mcp", "--project-id", "<your-project-id>"],
+      "env": {
+        "APIFOX_ACCESS_TOKEN": "<your-access-token>"
+      }
+    }
+  }
+}
+```
+
+## 功能特性
+
+- 支持 OpenAPI 3 和 Swagger 2 格式数据导入
+- 提供丰富的导入选项（目录、覆盖行为、分支等）
+- 基于 stdio 的 MCP 传输方式
+
+## 获取 Apifox 访问令牌
+
+1. 登录 [Apifox](https://app.apifox.com)
+2. 进入「开放平台」
+3. 创建系统级访问令牌
+4. 将令牌复制到 `mcp配置` 文件中
+
+## 获取 Apifox 项目 ID
+
+项目 ID 可以从 Apifox 项目 URL 中获取：
+1. 在 Apifox 中打开您的项目
+2. 浏览器地址栏的 URL 格式为：`https://app.apifox.com/project/{projectId}/...`
+3. `{projectId}` 部分即为项目 ID
+
+## 开发
+
+```bash
+# 构建
+npm run build
+
+# 运行
+npm start
+
+# 开发模式（构建后运行）
+npm run dev
+
+# 监听模式
+npm run watch
+```
+
+## MCP 工具
+
+### import-openapi
+
+将 OpenAPI 3/Swagger 2 数据导入到 Apifox 项目。项目 ID 需要在 MCP 配置中设置。
+
+#### 参数
+
+- `input` (必填): OpenAPI 数据，支持以下格式：
+  - `string`: JSON/YAML 格式的 OpenAPI 数据字符串
+- `options` (可选): 导入配置选项
+  - `targetEndpointFolderId`: 目标接口目录 ID
+  - `targetSchemaFolderId`: 目标数据模型目录 ID
+  - `endpointOverwriteBehavior`: 接口覆盖行为
+  - `schemaOverwriteBehavior`: 数据模型覆盖行为
+  - `updateFolderOfChangedEndpoint`: 是否更新接口目录
+  - `prependBasePath`: 是否添加基础路径
+  - `targetBranchId`: 目标分支 ID
+  - `moduleId`: 目标模块 ID
+
+#### 示例
+
+```json
+{
+  "input": "{\"openapi\":\"3.0.1\",\"info\":{\"title\":\"API\"},\"paths\":{}}",
+  "options": {
+    "targetEndpointFolderId": 0,
+    "endpointOverwriteBehavior": "OVERWRITE_EXISTING"
+  }
+}
+```
+
+## 许可证
+
+MIT

package/dist/apifox-client.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Apifox API 客户端
+ */
+import { EnvConfig, ImportRequest, ImportResponse, ImportError } from './types.js';
+export declare class ApifoxClient {
+    private baseUrl;
+    private apiVersion;
+    private accessToken;
+    constructor(config: EnvConfig);
+    /**
+     * 创建带有认证的请求头
+     */
+    private getHeaders;
+    /**
+     * 执行 HTTP POST 请求（带详细错误处理）
+     */
+    private post;
+    /**
+     * 导入 OpenAPI 数据到 Apifox
+     * @param projectId Apifox 项目 ID
+     * @param request 导入请求体
+     * @returns 导入结果
+     */
+    importOpenAPI(projectId: string, request: ImportRequest): Promise<ImportResponse>;
+    /**
+     * 格式化错误信息
+     */
+    static formatErrors(errors: ImportError[]): string;
+    /**
+     * 格式化导入结果为易读的文本
+     */
+    static formatImportResult(response: ImportResponse | any): string;
+}
+//# sourceMappingURL=apifox-client.d.ts.map

package/dist/apifox-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apifox-client.d.ts","sourceRoot":"","sources":["../src/apifox-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,SAAS;IAM7B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;YACW,IAAI;IAmClB;;;;;OAKG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC;IAc1B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IAUlD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,cAAc,GAAG,GAAG,GAC7B,MAAM;CAyDV"}

package/dist/apifox-client.js

@@ -0,0 +1,141 @@
+/**
+ * Apifox API 客户端
+ */
+export class ApifoxClient {
+    baseUrl;
+    apiVersion;
+    accessToken;
+    constructor(config) {
+        this.baseUrl = config.APIFOX_API_BASE_URL;
+        this.apiVersion = config.APIFOX_API_VERSION;
+        this.accessToken = config.APIFOX_ACCESS_TOKEN;
+    }
+    /**
+     * 创建带有认证的请求头
+     */
+    getHeaders() {
+        return {
+            'X-Apifox-Api-Version': this.apiVersion,
+            'Authorization': `Bearer ${this.accessToken}`,
+            'Content-Type': 'application/json',
+        };
+    }
+    /**
+     * 执行 HTTP POST 请求（带详细错误处理）
+     */
+    async post(url, body) {
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: this.getHeaders(),
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                let errorText = '';
+                try {
+                    errorText = await response.text();
+                    // 尝试解析 JSON 错误响应
+                    const errorJson = JSON.parse(errorText);
+                    if (errorJson.message) {
+                        errorText = errorJson.message;
+                    }
+                }
+                catch {
+                    // 如果不是 JSON，使用原始文本
+                }
+                throw new Error(`API request failed with status ${response.status}: ${errorText}`);
+            }
+            const json = await response.json();
+            return json;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to call Apifox API: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while calling Apifox API');
+        }
+    }
+    /**
+     * 导入 OpenAPI 数据到 Apifox
+     * @param projectId Apifox 项目 ID
+     * @param request 导入请求体
+     * @returns 导入结果
+     */
+    async importOpenAPI(projectId, request) {
+        const url = `${this.baseUrl}/v1/projects/${projectId}/import-openapi`;
+        try {
+            const response = await this.post(url, request);
+            return response;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to import OpenAPI: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while importing OpenAPI');
+        }
+    }
+    /**
+     * 格式化错误信息
+     */
+    static formatErrors(errors) {
+        if (errors.length === 0) {
+            return '无错误';
+        }
+        return errors
+            .map((error, index) => `${index + 1}. [${error.code}] ${error.message}`)
+            .join('\n');
+    }
+    /**
+     * 格式化导入结果为易读的文本
+     */
+    static formatImportResult(response) {
+        const result = [];
+        result.push('=== 导入结果 ===\n');
+        // 检查响应结构
+        if (!response.data) {
+            result.push('❌ 响应数据格式错误');
+            result.push(`响应内容: ${JSON.stringify(response, null, 2)}`);
+            return result.join('\n');
+        }
+        const { counters, errors } = response.data;
+        // 如果缺少 counters 或 errors，显示错误
+        if (!counters) {
+            result.push('❌ 响应缺少 counters 字段');
+            result.push(`响应内容: ${JSON.stringify(response, null, 2)}`);
+            return result.join('\n');
+        }
+        // 接口统计
+        result.push('📋 接口:');
+        result.push(`  新增: ${counters.endpointCreated || 0}`);
+        result.push(`  更新: ${counters.endpointUpdated || 0}`);
+        result.push(`  忽略: ${counters.endpointIgnored || 0}`);
+        result.push(`  失败: ${counters.endpointFailed || 0}`);
+        // 数据模型统计
+        result.push('\n📊 数据模型:');
+        result.push(`  新增: ${counters.schemaCreated || 0}`);
+        result.push(`  更新: ${counters.schemaUpdated || 0}`);
+        result.push(`  忽略: ${counters.schemaIgnored || 0}`);
+        result.push(`  失败: ${counters.schemaFailed || 0}`);
+        // 目录统计
+        result.push('\n📁 接口目录:');
+        result.push(`  新增: ${counters.endpointFolderCreated || 0}`);
+        result.push(`  更新: ${counters.endpointFolderUpdated || 0}`);
+        result.push(`  忽略: ${counters.endpointFolderIgnored || 0}`);
+        result.push(`  失败: ${counters.endpointFolderFailed || 0}`);
+        result.push('\n📂 数据模型目录:');
+        result.push(`  新增: ${counters.schemaFolderCreated || 0}`);
+        result.push(`  更新: ${counters.schemaFolderUpdated || 0}`);
+        result.push(`  忽略: ${counters.schemaFolderIgnored || 0}`);
+        result.push(`  失败: ${counters.schemaFolderFailed || 0}`);
+        // 错误信息
+        if (errors && errors.length > 0) {
+            result.push('\n❌ 错误信息:');
+            result.push(this.formatErrors(errors));
+        }
+        else {
+            result.push('\n✅ 导入成功，无错误');
+        }
+        return result.join('\n');
+    }
+}
+//# sourceMappingURL=apifox-client.js.map

package/dist/apifox-client.js.map

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

package/dist/http-server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HTTP 服务器实现 - 通过 HTTP/SSE 调用 MCP 服务器
+ */
+import type { EnvConfig } from './types.js';
+/**
+ * 启动 HTTP 服务器
+ * @param port 监听端口
+ * @param config 环境配置
+ */
+export declare function startHTTPServer(port: number, config: EnvConfig): Promise<void>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAqHpF"}

package/dist/http-server.js

@@ -0,0 +1,118 @@
+/**
+ * HTTP 服务器实现 - 通过 HTTP/SSE 调用 MCP 服务器
+ */
+import express from 'express';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { createServer as createMCPServer } from './server.js';
+/**
+ * 启动 HTTP 服务器
+ * @param port 监听端口
+ * @param config 环境配置
+ */
+export async function startHTTPServer(port, config) {
+    const app = express();
+    // 解析 JSON 请求体
+    app.use(express.json());
+    // 创建 MCP 服务器实例
+    const mcpServer = createMCPServer(config);
+    let transport = null;
+    // SSE 端点 - 建立 MCP 连接
+    app.get('/sse', async (req, res) => {
+        console.log('[HTTP] 新的 SSE 连接建立');
+        try {
+            // 创建 SSE 传输
+            transport = new SSEServerTransport('/messages', res);
+            // 连接 MCP 服务器
+            await mcpServer.connect(transport);
+            console.log('[HTTP] SSE 连接已建立');
+        }
+        catch (error) {
+            console.error('[HTTP] SSE 连接失败:', error);
+            res.status(500).send('SSE connection failed');
+        }
+    });
+    // SSE 消息端点 - 接收客户端发送的消息
+    app.post('/messages', async (req, res) => {
+        console.log('[HTTP] 收到消息:', JSON.stringify(req.body, null, 2));
+        if (!transport) {
+            res.status(400).json({ error: 'No active SSE connection' });
+            return;
+        }
+        try {
+            // 处理消息
+            await transport.handlePostMessage(req, res);
+        }
+        catch (error) {
+            console.error('[HTTP] 处理消息失败:', error);
+            res.status(500).json({ error: 'Failed to process message' });
+        }
+    });
+    // 健康检查端点
+    app.get('/health', (req, res) => {
+        res.json({ status: 'ok', service: 'mcp-apifox-import' });
+    });
+    // API 文档端点
+    app.get('/', (req, res) => {
+        res.json({
+            name: 'MCP Apifox Import Server',
+            version: '1.0.0',
+            description: '通过 HTTP/SSE 调用的 MCP 服务器，用于导入 OpenAPI 数据到 Apifox',
+            endpoints: {
+                sse: '/sse - SSE 连接端点（建立持久连接）',
+                messages: '/messages - 消息端点（POST 发送 MCP 请求）',
+                health: '/health - 健康检查',
+            },
+            usage: `
+1. 首先建立 SSE 连接: GET /sse
+2. 然后发送 MCP 请求: POST /messages
+
+请求格式示例:
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "tools/list"
+}
+
+或者调用导入工具:
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "method": "tools/call",
+  "params": {
+    "name": "import-openapi",
+    "arguments": {
+      "input": "{\\"openapi\\":\\"3.0.1\\"...}",
+      "options": {
+        "endpointOverwriteBehavior": "CREATE_NEW"
+      }
+    }
+  }
+}
+      `,
+        });
+    });
+    // 启动服务器
+    app.listen(port, () => {
+        console.log(`[HTTP] MCP 服务器已启动`);
+        console.log(`[HTTP] 监听地址: http://localhost:${port}`);
+        console.log(`[HTTP] SSE 端点: http://localhost:${port}/sse`);
+        console.log(`[HTTP] 消息端点: http://localhost:${port}/messages`);
+        console.log(`[HTTP] 健康检查: http://localhost:${port}/health`);
+    });
+    // 优雅关闭
+    process.on('SIGINT', async () => {
+        console.log('\n[HTTP] 正在关闭服务器...');
+        if (transport) {
+            await mcpServer.close();
+        }
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        console.log('\n[HTTP] 正在关闭服务器...');
+        if (transport) {
+            await mcpServer.close();
+        }
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/index-http.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MCP 服务器 HTTP 启动入口
+ */
+export {};
+//# sourceMappingURL=index-http.d.ts.map

package/dist/index-http.d.ts.map

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

package/dist/index-http.js

@@ -0,0 +1,38 @@
+/**
+ * MCP 服务器 HTTP 启动入口
+ */
+import { startHTTPServer } from './http-server.js';
+/**
+ * 从环境变量读取配置
+ */
+function loadConfig() {
+    const apiBaseUrl = process.env.APIFOX_API_BASE_URL || 'https://api.apifox.com';
+    const apiVersion = process.env.APIFOX_API_VERSION || '2024-03-28';
+    const accessToken = process.env.APIFOX_ACCESS_TOKEN || '';
+    const projectId = process.env.APIFOX_PROJECT_ID || '';
+    if (!accessToken) {
+        console.error('错误: 未设置 APIFOX_ACCESS_TOKEN 环境变量');
+        console.error('请创建 .env 文件并设置 APIFOX_ACCESS_TOKEN');
+        console.error('可以参考 .env.example 文件');
+        process.exit(1);
+    }
+    if (!projectId) {
+        console.error('错误: 未设置 APIFOX_PROJECT_ID 环境变量');
+        console.error('请创建 .env 文件并设置 APIFOX_PROJECT_ID');
+        console.error('可以参考 .env.example 文件');
+        process.exit(1);
+    }
+    return {
+        APIFOX_API_BASE_URL: apiBaseUrl,
+        APIFOX_API_VERSION: apiVersion,
+        APIFOX_ACCESS_TOKEN: accessToken,
+        APIFOX_PROJECT_ID: projectId,
+    };
+}
+// 加载环境配置
+const config = loadConfig();
+// 默认端口（可通过环境变量覆盖）
+const port = parseInt(process.env.MCP_HTTP_PORT || '3000', 10);
+// 启动 HTTP 服务器
+startHTTPServer(port, config);
+//# sourceMappingURL=index-http.js.map

package/dist/index-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-http.js","sourceRoot":"","sources":["../src/index-http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,SAAS,UAAU;IACjB,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,wBAAwB,CAAC;IAC9D,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,YAAY,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAEtD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CACX,kCAAkC,CACnC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,gCAAgC,CACjC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,mBAAmB,EAAE,UAAU;QAC/B,kBAAkB,EAAE,UAAU;QAC9B,mBAAmB,EAAE,WAAW;QAChC,iBAAiB,EAAE,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS;AACT,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAE5B,kBAAkB;AAClB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAE/D,cAAc;AACd,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * MCP Apifox Import Server 入口文件
+ */
+import type { EnvConfig } from './types.js';
+import { startServer } from './server.js';
+/**
+ * 从环境变量和命令行参数读取配置
+ */
+declare function loadConfig(): EnvConfig;
+export { loadConfig, startServer };
+export type { EnvConfig } from './types.js';
+//# 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":";AACA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,iBAAS,UAAU,IAAI,SAAS,CAgD/B;AAiBD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * MCP Apifox Import Server 入口文件
+ */
+import { startServer } from './server.js';
+/**
+ * 从环境变量和命令行参数读取配置
+ */
+function loadConfig() {
+    const apiBaseUrl = process.env.APIFOX_API_BASE_URL || 'https://api.apifox.com';
+    const apiVersion = process.env.APIFOX_API_VERSION || '2024-03-28';
+    const accessToken = process.env.APIFOX_ACCESS_TOKEN || '';
+    // 从命令行参数或环境变量获取 project-id
+    let projectId = process.env.APIFOX_PROJECT_ID || '';
+    const args = process.argv.slice(2);
+    const projectIdIndex = args.indexOf('--project-id');
+    if (projectIdIndex !== -1 && args[projectIdIndex + 1]) {
+        projectId = args[projectIdIndex + 1];
+    }
+    if (!accessToken) {
+        console.error('错误: 未设置 APIFOX_ACCESS_TOKEN 环境变量');
+        console.error('使用方法:');
+        console.error('  npx apifox-import-mcp');
+        console.error('  npx apifox-import-mcp --project-id <project-id>');
+        console.error('');
+        console.error('环境变量:');
+        console.error('  APIFOX_ACCESS_TOKEN (必需)');
+        console.error('  APIFOX_PROJECT_ID (可选，也可通过 --project-id 参数指定)');
+        console.error('  APIFOX_API_BASE_URL (可选，默认: https://api.apifox.com)');
+        process.exit(1);
+    }
+    if (!projectId) {
+        console.error('错误: 未设置 APIFOX_PROJECT_ID 环境变量或 --project-id 参数');
+        console.error('使用方法:');
+        console.error('  npx apifox-import-mcp --project-id <project-id>');
+        console.error('');
+        console.error('或设置环境变量:');
+        console.error('  export APIFOX_PROJECT_ID=<project-id>');
+        process.exit(1);
+    }
+    return {
+        APIFOX_API_BASE_URL: apiBaseUrl,
+        APIFOX_API_VERSION: apiVersion,
+        APIFOX_ACCESS_TOKEN: accessToken,
+        APIFOX_PROJECT_ID: projectId,
+    };
+}
+/**
+ * 主函数
+ */
+async function main() {
+    const config = loadConfig();
+    await startServer(config);
+}
+// 启动服务器
+main().catch((error) => {
+    console.error('服务器启动失败:', error);
+    process.exit(1);
+});
+// 导出供测试使用
+export { loadConfig, startServer };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,SAAS,UAAU;IACjB,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,wBAAwB,CAAC;IAC9D,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,YAAY,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAE1D,2BAA2B;IAC3B,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,cAAc,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC;QACtD,SAAS,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CACX,kCAAkC,CACnC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,iDAAiD,CAClD,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,mBAAmB,EAAE,UAAU;QAC/B,kBAAkB,EAAE,UAAU;QAC9B,mBAAmB,EAAE,WAAW;QAChC,iBAAiB,EAAE,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,QAAQ;AACR,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP 服务器实现
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { EnvConfig } from './types.js';
+/**
+ * 创建 MCP 服务器
+ */
+export declare function createServer(config: EnvConfig): Server;
+/**
+ * 启动服务器
+ */
+export declare function startServer(config: EnvConfig): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA+GtD;AA2GD;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlE"}

package/dist/server.js

@@ -0,0 +1,219 @@
+/**
+ * MCP 服务器实现
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { ApifoxClient } from './apifox-client.js';
+/**
+ * 创建 MCP 服务器
+ */
+export function createServer(config) {
+    // 创建 Apifox 客户端实例
+    const apifoxClient = new ApifoxClient(config);
+    // 创建 MCP 服务器
+    const server = new Server({
+        name: 'mcp-apifox-import',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // 注册工具列表处理程序
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'import-openapi',
+                    description: '将 OpenAPI 3 或 Swagger 2 格式的数据导入到 Apifox 项目。支持字符串（JSON/YAML）或 URL 两种方式。',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            input: {
+                                type: 'string',
+                                description: 'OpenAPI 数据字符串（JSON 或 YAML 格式）'
+                            },
+                            options: {
+                                type: 'object',
+                                description: '导入配置选项',
+                                properties: {
+                                    targetEndpointFolderId: {
+                                        type: 'number',
+                                        description: '目标接口目录 ID（未指定则使用 Root 目录）',
+                                    },
+                                    targetSchemaFolderId: {
+                                        type: 'number',
+                                        description: '目标数据模型目录 ID（未指定则使用 Root 目录）',
+                                    },
+                                    endpointOverwriteBehavior: {
+                                        type: 'string',
+                                        enum: [
+                                            'OVERWRITE_EXISTING',
+                                            'AUTO_MERGE',
+                                            'KEEP_EXISTING',
+                                            'CREATE_NEW',
+                                        ],
+                                        description: '接口覆盖行为',
+                                    },
+                                    schemaOverwriteBehavior: {
+                                        type: 'string',
+                                        enum: [
+                                            'OVERWRITE_EXISTING',
+                                            'AUTO_MERGE',
+                                            'KEEP_EXISTING',
+                                            'CREATE_NEW',
+                                        ],
+                                        description: '数据模型覆盖行为',
+                                    },
+                                    updateFolderOfChangedEndpoint: {
+                                        type: 'boolean',
+                                        description: '是否更新接口目录',
+                                    },
+                                    prependBasePath: {
+                                        type: 'boolean',
+                                        description: '是否添加基础路径',
+                                    },
+                                    targetBranchId: {
+                                        type: 'number',
+                                        description: '目标分支 ID',
+                                    },
+                                    moduleId: {
+                                        type: 'number',
+                                        description: '目标模块 ID',
+                                    },
+                                },
+                            },
+                        },
+                        required: ['input'],
+                    },
+                },
+            ],
+        };
+    });
+    // 注册工具调用处理程序
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (name === 'import-openapi') {
+            return await handleImportOpenAPI(apifoxClient, config, args);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `未知的工具: ${name}`,
+                },
+            ],
+            isError: true,
+        };
+    });
+    return server;
+}
+/**
+ * 处理 import-openapi 工具调用
+ */
+async function handleImportOpenAPI(client, config, args) {
+    // 参数验证
+    const schema = z.object({
+        input: z.union([
+            z.string().min(1, '输入数据不能为空'),
+            z.object({
+                url: z.string().url('URL 格式不正确'),
+                basicAuth: z
+                    .object({
+                    username: z.string(),
+                    password: z.string(),
+                })
+                    .optional(),
+            }),
+        ]),
+        options: z
+            .object({
+            targetEndpointFolderId: z.number().optional(),
+            targetSchemaFolderId: z.number().optional(),
+            endpointOverwriteBehavior: z
+                .enum([
+                'OVERWRITE_EXISTING',
+                'AUTO_MERGE',
+                'KEEP_EXISTING',
+                'CREATE_NEW',
+            ])
+                .optional(),
+            schemaOverwriteBehavior: z
+                .enum([
+                'OVERWRITE_EXISTING',
+                'AUTO_MERGE',
+                'KEEP_EXISTING',
+                'CREATE_NEW',
+            ])
+                .optional(),
+            updateFolderOfChangedEndpoint: z.boolean().optional(),
+            prependBasePath: z.boolean().optional(),
+            targetBranchId: z.number().optional(),
+            moduleId: z.number().optional(),
+        })
+            .optional(),
+    });
+    const validationResult = schema.safeParse(args);
+    if (!validationResult.success) {
+        const errors = validationResult.error.errors
+            .map((e) => `${e.path.join('.')}: ${e.message}`)
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `参数验证失败:\n${errors}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const { input, options } = validationResult.data;
+    const projectId = config.APIFOX_PROJECT_ID;
+    try {
+        // 调用 Apifox API
+        const response = await client.importOpenAPI(projectId, {
+            input,
+            options,
+        });
+        // 格式化结果
+        const formattedResult = ApifoxClient.formatImportResult(response);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: formattedResult,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : '未知错误';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `导入失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * 启动服务器
+ */
+export async function startServer(config) {
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // 优雅关闭
+    process.on('SIGINT', async () => {
+        await server.close();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Apifox Import API 类型定义
+ */
+export type OverwriteBehavior = 'OVERWRITE_EXISTING' | 'AUTO_MERGE' | 'KEEP_EXISTING' | 'CREATE_NEW';
+export interface BasicAuth {
+    username: string;
+    password: string;
+}
+export interface UrlInput {
+    url: string;
+    basicAuth?: BasicAuth;
+}
+export type OpenAPIInput = string | UrlInput;
+export interface ImportOptions {
+    targetEndpointFolderId?: number;
+    targetSchemaFolderId?: number;
+    endpointOverwriteBehavior?: OverwriteBehavior;
+    schemaOverwriteBehavior?: OverwriteBehavior;
+    updateFolderOfChangedEndpoint?: boolean;
+    prependBasePath?: boolean;
+    targetBranchId?: number;
+    moduleId?: number;
+}
+export interface ImportRequest {
+    input: OpenAPIInput;
+    options?: ImportOptions;
+}
+export interface Counters {
+    endpointCreated: number;
+    endpointUpdated: number;
+    endpointFailed: number;
+    endpointIgnored: number;
+    schemaCreated: number;
+    schemaUpdated: number;
+    schemaFailed: number;
+    schemaIgnored: number;
+    endpointFolderCreated: number;
+    endpointFolderUpdated: number;
+    endpointFolderFailed: number;
+    endpointFolderIgnored: number;
+    schemaFolderCreated: number;
+    schemaFolderUpdated: number;
+    schemaFolderFailed: number;
+    schemaFolderIgnored: number;
+}
+export interface ImportError {
+    message: string;
+    code: string;
+}
+export interface ImportResponseData {
+    counters: Counters;
+    errors: ImportError[];
+}
+export interface ImportResponse {
+    data: ImportResponseData;
+}
+export interface EnvConfig {
+    APIFOX_API_BASE_URL: string;
+    APIFOX_API_VERSION: string;
+    APIFOX_ACCESS_TOKEN: string;
+    APIFOX_PROJECT_ID: string;
+}
+export interface ImportOpenAPIToolArgs {
+    input: OpenAPIInput;
+    options?: ImportOptions;
+}
+export interface FormattedCounters {
+    label: string;
+    created: number;
+    updated: number;
+    failed: number;
+    ignored: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,iBAAiB,GACzB,oBAAoB,GACpB,YAAY,GACZ,eAAe,GACf,YAAY,CAAC;AAGjB,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAGD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAG7C,MAAM,WAAW,aAAa;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,iBAAiB,CAAC;IAC9C,uBAAuB,CAAC,EAAE,iBAAiB,CAAC;IAC5C,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAGD,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAGD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAGD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAGD,MAAM,WAAW,SAAS;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAGD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAGD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Apifox Import API 类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "apifox-import-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for importing OpenAPI data to Apifox",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "apifox-import-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "watch": "tsc --watch",
+    "test:prepare": "npm run build",
+    "publish:npm": "npm run build && npm publish"
+  },
+  "keywords": [
+    "mcp",
+    "apifox",
+    "openapi",
+    "swagger",
+    "import"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@types/express": "^5.0.6",
+    "express": "^5.2.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}