# Apifox MCP Service

这是一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 标准实现的 Apifox 服务端。它充当 LLM (如 Claude, Gemini 等) 与 Apifox API 文档之间的桥梁，允许 AI 助手直接检索 Apifox 中的接口定义，并根据定义生成强类型的 API 请求代码。

## ✨ 功能特性

*   **MCP 协议支持**: 支持标准 MCP 协议，可集成到 Claude Desktop, Cursor 等支持 MCP 的客户端。
*   **多传输模式**: 支持 `stdio` (标准输入输出，默认) 和 `http` (SSE 流式传输) 两种模式。
*   **接口检索**:
    *   `get_api_by_path`: 根据路径获取指定接口的详细定义 (Schema)。
    *   `get_apis_by_folder`: 获取指定目录下的所有接口定义。
*   **AI 提示词 (Prompts)**:
    *   `gen-api-by-path`: 指导 AI 根据接口路径生成 API 代码。
    *   `gen-api-by-folder`: 指导 AI 根据目录批量生成 API 代码。
*   **健康检查**: HTTP 模式下提供 `/health` 端点。

## 🛠️ 安装与配置

### 前置要求

*   Node.js (v18 或更高版本)
*   Apifox 账号及项目访问权限

### 环境变量

运行此服务需要配置以下环境变量：

| 变量名 | 描述 |
| :--- | :--- |
| `APIFOX_PROJECT_ID` | 你的 Apifox 项目 ID (数字) |
| `APIFOX_TOKEN` | 你的 Apifox 访问令牌 (Bearer Token) |

### 安装依赖

```bash
npm install
```

## 🚀 启动服务

### 1. Stdio 模式 (默认)

适用于 Claude Desktop 或作为子进程运行的场景。

```bash
# 需确保环境变量已设置
export APIFOX_PROJECT_ID=你的项目ID
export APIFOX_TOKEN=你的Token

node index.js
# 或显式指定
node index.js --transport stdio
```

### 2. HTTP (SSE) 模式

适用于远程部署或需要 HTTP 访问的场景。

```bash
node index.js --transport http --port 8889
```

*   **Endpoint**: `http://localhost:8889/sse`
*   **Health Check**: `http://localhost:8889/health`

## 💻 客户端集成示例

### Claude Desktop 配置

编辑 Claude Desktop 的配置文件 (通常位于 `%APPDATA%\Claude\claude_desktop_config.json` 或 `~/Library/Application Support/Claude/claude_desktop_config.json`)：

```json
{
  "mcpServers": {
    "apifox": {
      "command": "node",
      "args": [
        "D:/demo/apifox-mcp-service/index.js"
      ],
      "env": {
        "APIFOX_PROJECT_ID": "123456",
        "APIFOX_TOKEN": "apifox_pat_xxxxxxxx"
      }
    }
  }
}
```

*注意：请将路径替换为你本地的实际绝对路径。*

## 📚 工具详情

### Tools

#### `get_api_by_path`
根据接口路径获取 Apifox 接口定义数据。
*   参数: `path` (string), `projectId` (number, 可选)

#### `get_apis_by_folder`
根据接口目录名称获取目录下所有接口定义。
*   参数: `folderName` (string), `projectId` (number, 可选)

### Prompts

#### `gen-api-by-path`
流程化 Prompt，引导 LLM 获取接口定义并生成符合项目规范的 API 代码。

#### `gen-api-by-folder`
流程化 Prompt，引导 LLM 批量获取目录下接口并生成代码。

## 📝 License

ISC