Apifox MCP Pro

Apifox MCP Pro

English | 中文

---

English

⚠️ 项目状态说明 / Project Status

由于Apifox官方开放API功能极其有限（仅提供3个基础导入导出接口），本项目已从最初计划的33+个工具简化为9个诊断和信息查询工具。大部分API管理功能需要使用Apifox Web界面或桌面客户端。

Due to Apifox's extremely limited Open API (only 3 basic import/export endpoints), this project has been simplified from the originally planned 33+ tools to 9 diagnostic and information tools. Most API management features require using the Apifox web interface or desktop client.

---

Servicio MCP mejorado de Apifox con capacidades básicas de diagnóstico e información para Claude Desktop y Cursor.

🆚 Comparación con el MCP oficial

Característica	MCP oficial	Apifox MCP Pro
Número de herramientas	3 herramientas	9 herramientas (limitado)
Gestión de proyectos	❌	⚠️ Solo información básica
CRUD de API	❌	❌ No compatible
Operaciones por lotes	❌	❌ No compatible
Soporte para Cursor	❌	✅ Soporte nativo
Instalación mediante NPM	❌	✅ Instalación en un clic
Herramientas CLI	❌	✅ CLI completo

⚠️ Limitaciones importantes

Debido a la API abierta extremadamente limitada de Apifox, la mayoría de las funciones avanzadas no están disponibles:

• ❌ Gestión de interfaces de API - No se pueden listar, crear, actualizar ni eliminar APIs
• ❌ Gestión de carpetas - No se admiten operaciones con carpetas
• ❌ Gestión de entornos - No se pueden gestionar entornos
• ❌ Gestión de modelos de datos - No hay operaciones de esquema
• ❌ Gestión de casos de prueba - No se pueden gestionar casos de prueba
• ❌ Funcionalidad de búsqueda - No se admite la búsqueda de APIs
• ❌ Operaciones por lotes - No hay operaciones masivas disponibles

Lo que SÍ está disponible:

• ✅ Información básica del proyecto - Obtener información del proyecto y comprobaciones de acceso
• ✅ Explicaciones de limitaciones - Documentación clara de lo que no es compatible
• ✅ Validación de tokens - Comprobar si su token de acceso funciona
• ✅ Herramientas de diagnóstico - Ayudan a comprender las limitaciones de la API

Motivo: Apifox proporciona oficialmente solo 3 endpoints básicos de importación/exportación de API. La mayoría de las funciones de gestión requieren el uso de la interfaz web o el cliente de escritorio de Apifox.

Características

• 🚀 9 herramientas MCP - Herramientas básicas de diagnóstico e información
• 📋 Información del proyecto - Obtener información básica del proyecto y estado de acceso
• ⚠️ Conciencia de limitaciones - Documentación clara de las restricciones de la API
• 🔍 Herramientas de diagnóstico - Comprobar la validez del token y el acceso al proyecto
• 💻 Multiplataforma - Funciona con Claude Desktop y Cursor
• 📦 Paquete NPM - Instalación sencilla mediante npm
• 🛠️ Herramientas CLI - Utilidades de configuración y ajuste

Nota: Debido a la API abierta limitada de Apifox, las funciones avanzadas de gestión no están disponibles. Esta herramienta sirve principalmente como utilidad de diagnóstico e información.

Inicio rápido

Opción 1: Instalación mediante NPM (recomendada)

# Install globally
npm install -g apifox-mcp-pro

# Set your Apifox access token
export APIFOX_ACCESS_TOKEN="your_access_token_here"

# Setup for Cursor
apifox-mcp-pro setup --cursor

# Setup for Claude Desktop
apifox-mcp-pro setup --claude

# Setup for both
apifox-mcp-pro setup --both

Opción 2: Desarrollo local

# Clone the repository
git clone https://github.com/guocong-bincai/Apifox_mcp_pro.git
cd Apifox_mcp_pro

# Install dependencies
npm install

# Build the project
npm run build

# Set environment variables
cp .env.example .env
# Edit .env and add your APIFOX_ACCESS_TOKEN

# Setup local configuration
npm run dev setup --both --local

Configuración

Obtención de su token de acceso de Apifox

1. Inicie sesión en el sitio web de Apifox
2. Vaya a Configuración personal → Token de acceso a la API
3. Cree un nuevo token de acceso
4. Copie el token generado (el formato suele ser APS-xxxxxxxxxx)

⚠️ Aviso de seguridad:

• Guarde su token de acceso de forma segura; no lo codifique en el código
• No envíe archivos de configuración que contengan tokens reales a repositorios públicos
• Utilice variables de entorno o archivos de configuración para gestionar los tokens

Variables de entorno

Cree un archivo .env o establezca variables de entorno:

# Required - 从Apifox个人设置中获取
APIFOX_ACCESS_TOKEN=your_apifox_access_token_here

# Optional
APIFOX_BASE_URL=https://api.apifox.com  # Default API base URL
LOG_LEVEL=info                          # Log level: debug, info, warn, error

Ejemplo de archivo .env:

# .env 文件示例（请替换为您的真实令牌）
APIFOX_ACCESS_TOKEN=APS-your-actual-token-here
LOG_LEVEL=info

Configuración de Cursor

Después de ejecutar apifox-mcp-pro setup --cursor, el servidor MCP se configurará automáticamente. También puede añadirlo manualmente a la configuración de Cursor:

{
  "mcpServers": {
    "apifox-mcp-pro": {
      "command": "npx",
      "args": ["apifox-mcp-pro"],
      "env": {
        "APIFOX_ACCESS_TOKEN": "your_apifox_access_token_here"
      }
    }
  }
}

Configuración de Claude Desktop

Para Claude Desktop, añada a su claude_desktop_config.json:

{
  "mcpServers": {
    "apifox-mcp-pro": {
      "command": "npx",
      "args": ["apifox-mcp-pro"],
      "env": {
        "APIFOX_ACCESS_TOKEN": "your_apifox_access_token_here"
      }
    }
  }
}

Herramientas disponibles (9 en total)

Información del proyecto (2 herramientas)

• apifox_project_info - Obtener la descripción general de la funcionalidad y las limitaciones de MCP
• apifox_check_access - Comprobar la validez del token y los permisos de acceso

Información de la API (2 herramientas)

• apifox_api_info - Obtener la explicación de las limitaciones de la gestión de API
• apifox_check_project_access - Comprobar el acceso a un proyecto específico

Información sobre limitaciones de funciones (5 herramientas)

• apifox_folder_info - Limitaciones de la gestión de carpetas
• apifox_environment_info - Limitaciones de la gestión de entornos
• apifox_schema_info - Limitaciones de la gestión de modelos de datos
• apifox_test_info - Limitaciones de la gestión de casos de prueba
• apifox_import_export_info - Información sobre la funcionalidad de importación/exportación

❌ Herramientas eliminadas (listadas anteriormente pero no funcionales)

Las siguientes herramientas se eliminaron porque la API abierta de Apifox no las admite:

Gestión de API (9 eliminadas)

• apifox_list_apis - No se admite el listado de APIs
• apifox_get_api - No se puede acceder a los detalles de la API
• apifox_create_api - No se admite la creación de APIs
• apifox_update_api - No se admiten las actualizaciones de APIs
• apifox_delete_api - No se admite la eliminación de APIs
• apifox_search_apis - Funcionalidad de búsqueda no disponible
• apifox_batch_delete_apis - No se admiten operaciones por lotes
• apifox_batch_update_api_status - No se admiten actualizaciones de estado
• apifox_batch_move_apis - No se admite el movimiento de APIs

Gestión de proyectos (4 eliminadas)

• apifox_list_projects - Acceso a la API limitado
• apifox_create_project - No se admite la creación
• apifox_update_project - No se admiten las actualizaciones
• apifox_delete_project - No se admite la eliminación

Todas las demás herramientas de gestión (14 eliminadas)

• Todas las herramientas de gestión de carpetas, entornos, esquemas, casos de prueba e importación/exportación

Motivo de la eliminación: La API abierta de Apifox es extremadamente limitada y solo proporciona 3 endpoints básicos de importación/exportación. Todas las operaciones de gestión requieren el uso de la interfaz web o la aplicación de escritorio de Apifox.

Ejemplos de uso

Obtención de información de MCP

// In Claude or Cursor, you can ask:
"What Apifox MCP Pro features are available?"

// This will call:
apifox_project_info()

Comprobación del acceso

// Check if your token works:
"Check my Apifox access permissions"

// This will call:
apifox_check_access()

Comprensión de las limitaciones

// Get information about API management limitations:
"Why can't I list APIs in my Apifox project?"

// This will call:
apifox_api_info()

Soluciones alternativas

Dado que la mayoría de las funciones de gestión no están disponibles a través de la API, considere estas alternativas:

// List all APIs in a project
"Show me all APIs in project 12345"

// Create a new API
"Create a GET API at /users/{id} for getting user details in project 12345"

// Search APIs
"Find all POST APIs in project 12345"

Operaciones por lotes

// Batch update API status
"Mark APIs with IDs [1, 2, 3] as 'released'"

// Batch move APIs
"Move APIs [4, 5, 6] to folder 'v2-apis'"

Comandos CLI

# Start MCP server (default)
apifox-mcp-pro

# Setup configuration
apifox-mcp-pro setup --cursor          # Setup for Cursor
apifox-mcp-pro setup --claude          # Setup for Claude Desktop
apifox-mcp-pro setup --both            # Setup for both
apifox-mcp-pro setup --local           # Use local node instead of npx
apifox-mcp-pro setup --examples        # Generate config examples only

# Show version
apifox-mcp-pro --version

# Show help
apifox-mcp-pro --help

Desarrollo

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

# Lint code
npm run lint

# Format code
npm run format

Archivos de configuración

El comando de configuración genera varios archivos de configuración:

• cursor-mcp-config.json - Configuración de MCP para Cursor
• claude-desktop-config.json - Configuración de Claude Desktop
• local-config-example.json - Configuración de desarrollo local

Solución de problemas

Problemas comunes

1. Problemas con el token de acceso

   # Make sure your token is set correctly
   echo $APIFOX_ACCESS_TOKEN
   
   # Or check in your IDE configuration
   

2. Problemas de instalación

   # Clear npm cache and reinstall
   npm cache clean --force
   npm install -g apifox-mcp-pro
   

3. Problemas de configuración

   # Regenerate configuration files
   apifox-mcp-pro setup --both --examples
   

Obtención de ayuda

• Consulte USAGE.md para obtener instrucciones de uso detalladas
• Revise los archivos de configuración generados
• Compruebe los permisos de su token de acceso de Apifox
• Verifique la configuración de MCP de su IDE

Contribuciones

1. Haga un fork del repositorio
2. Cree una rama de funcionalidad
3. Realice sus cambios
4. Añada pruebas si corresponde
5. Envíe una solicitud de extracción

Licencia

Licencia MIT: consulte el archivo LICENSE para obtener más detalles.

Registro de cambios

v1.0.0

• Lanzamiento inicial con 33 herramientas MCP
• Soporte de paquete NPM
• Integración con Cursor y Claude Desktop
• Funciones completas de gestión de API
• Herramientas de configuración CLI

---

Nota: Esta es una versión mejorada del servicio MCP oficial de Apifox, que proporciona significativamente más funcionalidad que la implementación oficial básica.

---

中文

⚠️ 项目状态说明

由于Apifox官方开放API功能极其有限（仅提供3个基础导入导出接口），本项目已从最初计划的33+个工具简化为9个诊断和信息查询工具。大部分API管理功能需要使用Apifox Web界面或桌面客户端。

---

为 Claude Desktop 和 Cursor 提供基础诊断和信息功能的 Apifox MCP 服务。

🆚 与官方 MCP 对比

功能	官方 MCP	Apifox MCP Pro
工具数量	3个	9个工具（受限）
项目管理	❌	⚠️ 仅基础信息
API CRUD	❌	❌ 不支持
批量操作	❌	❌ 不支持
Cursor 支持	❌	✅ 原生支持
NPM 安装	❌	✅ 一键安装
CLI 工具	❌	✅ 完整 CLI

⚠️ 重要限制

由于Apifox开放API功能极其有限，大部分高级功能不可用：

• ❌ API接口管理 - 无法列出、创建、更新或删除API
• ❌ 文件夹管理 - 不支持文件夹操作
• ❌ 环境管理 - 无法管理环境
• ❌ 数据模型管理 - 不支持Schema操作
• ❌ 测试用例管理 - 无法管理测试用例
• ❌ 搜索功能 - 不支持API搜索
• ❌ 批量操作 - 不支持批量操作

可用功能：

• ✅ 基础项目信息 - 获取项目信息和访问检查
• ✅ 限制说明 - 清晰的不支持功能文档
• ✅ 令牌验证 - 检查访问令牌是否有效
• ✅ 诊断工具 - 帮助理解API限制

原因： Apifox官方仅提供3个基础导入导出API端点。大部分管理功能需要使用Apifox Web界面或桌面客户端。

功能特性

• 🚀 9个MCP工具 - 基础诊断和信息工具
• 📋 项目信息 - 获取基础项目信息和访问状态
• ⚠️ 限制说明 - 清晰的API限制文档
• 🔍 诊断工具 - 检查令牌有效性和项目访问
• 💻 跨平台 - 支持 Claude Desktop 和 Cursor
• 📦 NPM 包 - 通过 npm 轻松安装
• 🛠️ CLI 工具 - 设置和配置工具

注意： 由于Apifox开放API限制，高级管理功能不可用。此工具主要作为诊断和信息查询工具使用。

快速开始

方式一：NPM 安装（推荐）

# 全局安装
npm install -g apifox-mcp-pro

# 设置 Apifox 访问令牌
export APIFOX_ACCESS_TOKEN="your_access_token_here"

# 配置 Cursor
apifox-mcp-pro setup --cursor

# 配置 Claude Desktop
apifox-mcp-pro setup --claude

# 同时配置两者
apifox-mcp-pro setup --both

方式二：本地开发

# 克隆仓库
git clone https://github.com/guocong-bincai/Apifox_mcp_pro.git
cd Apifox_mcp_pro

# 安装依赖
npm install

# 构建项目
npm run build

# 设置环境变量
cp .env.example .env
# 编辑 .env 文件并添加你的 APIFOX_ACCESS_TOKEN

# 设置本地配置
npm run dev setup --both --local

配置

环境变量

创建 .env 文件或设置环境变量：

# 必需
APIFOX_ACCESS_TOKEN=your_apifox_access_token_here

# 可选
APIFOX_BASE_URL=https://api.apifox.com  # 默认 API 基础 URL
LOG_LEVEL=info                          # 日志级别：debug, info, warn, error

Cursor 配置

运行 apifox-mcp-pro setup --cursor 后，MCP 服务器将自动配置。您也可以手动添加到 Cursor 设置中：

{
  "mcpServers": {
    "apifox-mcp-pro": {
      "command": "npx",
      "args": ["apifox-mcp-pro"],
      "env": {
        "APIFOX_ACCESS_TOKEN": "your_apifox_access_token_here"
      }
    }
  }
}

Claude Desktop 配置

对于 Claude Desktop，添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "apifox-mcp-pro": {
      "command": "npx",
      "args": ["apifox-mcp-pro"],
      "env": {
        "APIFOX_ACCESS_TOKEN": "your_apifox_access_token_here"
      }
    }
  }
}

可用工具（共9个）

项目信息（2个工具）

• apifox_project_info - 获取MCP功能概览和限制信息
• apifox_check_access - 检查令牌有效性和访问权限

API信息（2个工具）

• apifox_api_info - 获取API管理限制说明
• apifox_check_project_access - 检查特定项目访问权限

功能限制信息（5个工具）

• apifox_folder_info - 文件夹管理限制说明
• apifox_environment_info - 环境管理限制说明
• apifox_schema_info - 数据模型管理限制说明
• apifox_test_info - 测试用例管理限制说明
• apifox_import_export_info - 导入导出功能信息

❌ 已删除的工具（之前列出但不可用）

由于Apifox开放API不支持，以下工具已被删除：

API管理（9个已删除）

• apifox_list_apis - 不支持API列表查询
• apifox_get_api - 无法访问API详情
• apifox_create_api - 不支持API创建
• apifox_update_api - 不支持API更新
• apifox_delete_api - 不支持API删除
• apifox_search_apis - 搜索功能不可用
• apifox_batch_delete_apis - 不支持批量操作
• apifox_batch_update_api_status - 不支持状态更新
• apifox_batch_move_apis - 不支持移动API

项目管理（4个已删除）

• apifox_list_projects - API访问受限
• apifox_create_project - 不支持创建
• apifox_update_project - 不支持更新
• apifox_delete_project - 不支持删除

其他所有管理工具（14个已删除）

• 所有文件夹、环境、数据模型、测试用例和导入导出管理工具

删除原因： Apifox开放API功能极其有限，仅提供3个基础导入导出端点。所有管理操作需要使用Apifox Web界面或桌面应用程序。

使用示例

获取MCP信息

// 在 Claude 或 Cursor 中，您可以询问：
"Apifox MCP Pro 有哪些可用功能？"

// 这将调用：
apifox_project_info()

检查访问权限

// 检查令牌是否有效：
"检查我的 Apifox 访问权限"

// 这将调用：
apifox_check_access()

了解限制

// 获取API管理限制信息：
"为什么我无法列出 Apifox 项目中的 API？"

// 这将调用：
apifox_api_info()

替代解决方案

由于大部分管理功能通过API不可用，请考虑以下替代方案：

• 使用 Apifox Web界面 进行完整的API管理
• 使用 Apifox 桌面客户端获得最佳体验
• 等待官方完善开放API功能

CLI 命令

# 启动 MCP 服务器（默认）
apifox-mcp-pro

# 设置配置
apifox-mcp-pro setup --cursor          # 设置 Cursor
apifox-mcp-pro setup --claude          # 设置 Claude Desktop
apifox-mcp-pro setup --both            # 设置两者
apifox-mcp-pro setup --local           # 使用本地 node 而不是 npx
apifox-mcp-pro setup --examples        # 仅生成配置示例

# 显示版本
apifox-mcp-pro --version

# 显示帮助
apifox-mcp-pro --help

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式运行
npm run dev

# 运行测试
npm test

# 代码检查
npm run lint

# 格式化代码
npm run format

配置文件

setup 命令会生成几个配置文件：

• cursor-mcp-config.json - Cursor MCP 配置
• claude-desktop-config.json - Claude Desktop 配置
• local-config-example.json - 本地开发配置

故障排除

常见问题

1. 访问令牌问题

   # 确保您的令牌设置正确
   echo $APIFOX_ACCESS_TOKEN
   
   # 或检查您的 IDE 配置
   

2. 安装问题

   # 清除 npm 缓存并重新安装
   npm cache clean --force
   npm install -g apifox-mcp-pro
   

3. 配置问题

   # 重新生成配置文件
   apifox-mcp-pro setup --both --examples
   

获取帮助

• 查看 USAGE.md 了解详细使用说明
• 查看生成的配置文件
• 检查您的 Apifox 访问令牌权限
• 验证您的 IDE MCP 配置

贡献

1. Fork 仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交 Pull Request

许可证

MIT 许可证 - 详见 LICENSE 文件。

更新日志

v1.0.0

• 首次发布，包含 33 个 MCP 工具
• NPM 包支持
• Cursor 和 Claude Desktop 集成
• 全面的 API 管理功能
• CLI 设置工具

---

注意：这是官方 Apifox MCP 服务的增强版本，提供比基础官方实现更多的功能。