feat: 添加 README 文档并实现 HTTP 传输模式支持

README.md

@@ -0,0 +1,113 @@
+# 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