摘要
逐步指南，将任何 REST API 转换为与 AnythingMCP 兼容的 MCP 服务器。无需编码。
什么是模型上下文协议 (MCP)？
模型上下文协议 (MCP) 是一种开放标准，允许像 Claude、ChatGPT 等 AI 代理以结构化的方式与外部工具和数据源进行交互。MCP 定义了 AI 模型如何发现、理解和使用工具。
为什么将 REST API 转换为 MCP？
大多数商业应用程序都公开 REST API。通过将这些转换为 MCP 服务器，你可以使 AI 代理能够：
- 从内部系统读取和写入数据
- 通过自然语言执行业务工作流
- 访问数据库和服务中的实时信息
逐步指南
第 1 步：部署 AnythingMCP
克隆仓库并使用 Docker Compose 启动应用程序：
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
这将启动 PostgreSQL、后端 API（端口 4000）和仪表板（端口 3000）。
第 2 步：创建 REST 连接器
在 http://localhost:3000 打开 AnythingMCP 仪表板并创建一个新的 REST 连接器。你可以从多个来源导入 API 定义：
- OpenAPI/Swagger — 上传或粘贴你的 OpenAPI 规范 URL
- Postman 集合 — 直接从 Postman JSON 导出导入
- cURL 命令 — 粘贴 cURL 命令，AnythingMCP 将解析它们为端点
第 3 步：配置身份验证
在连接器设置中，为你的 API 配置身份验证。AnythingMCP 支持 Bearer 令牌、API 密钥、基本身份验证和 OAuth2。可以使用环境变量来存储密钥。
第 4 步：审查和自定义工具
AnythingMCP 会根据你的 API 端点自动生成 MCP 工具。在仪表板中，你可以审查每个工具，自定义名称和描述，并选择公开或隐藏哪些端点。
第 5 步：在仪表板中测试工具
使用内置的工具测试界面直接从仪表板调用每个工具，并在连接 AI 代理之前验证响应。
第 6 步：连接到 AI 代理
配置你的 MCP 客户端（Claude Desktop、Claude.ai、Cursor、Windsurf 或任何与 MCP 兼容的代理）以连接到你的 AnythingMCP 服务器：
{
"mcpServers": {
"my-api": {
"url": "http://localhost:4000/mcp"
}
}
}
最佳实践
- 从只读端点开始 — 首先公开 GET 端点，然后添加写入操作
- 使用有意义的名称 — 在仪表板中自定义工具名称以提高清晰度
- 添加描述 — 帮助 AI 代理理解每个工具的功能
- 速率限制 — 配置速率限制以保护你的 API
下一步
- SOAP 转 MCP 指南 — 转换 SOAP 服务
- 数据库转 MCP 指南 — 直接连接数据库
这份指南对你有帮助吗?
