Summary
将 REST API 转换为 Claude、ChatGPT 和 Copilot 的 MCP 服务器的完整指南。使用 AnythingMCP 将任何 REST 端点转变为 AI 准备好的工具。
为什么将 REST API 转换为 MCP?
模型上下文协议 (MCP) 是一种标准,使得像 Claude、ChatGPT 和 Copilot 这样的 AI 助手能够与外部工具进行交互。通过将你的 REST API 转换为 MCP 服务器,你允许 AI 代理使用自然语言调用你的端点——无需自定义代码。
你需要的东西
- 一个 REST API(任何带有 HTTP 端点的 API)
- 在你的机器上安装 Docker
- 一个与 MCP 兼容的 AI 客户端(Claude Desktop、Claude.ai、ChatGPT、Copilot、Cursor 等)
步骤:转换你的 REST API
第一步:部署 AnythingMCP
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
这将启动后端(端口 4000)、仪表板(端口 3000)和 PostgreSQL。
第二步:创建 REST 连接器
在 http://localhost:3000 打开仪表板并创建一个新的 REST 连接器。你可以从以下方式导入你的 API:
- OpenAPI/Swagger 规范 — 粘贴 URL 或上传 JSON/YAML 文件
- Postman 集合 — 直接导入 Postman 导出
- cURL 命令 — 粘贴 cURL 命令,AnythingMCP 将其解析为端点
第三步:配置身份验证
在连接器设置中设置你的 API 的身份验证方法:
- Bearer Token
- API Key(头部或查询)
- Basic Auth
- OAuth 2.0
环境变量可用于存储秘密,以便它们不出现在你的配置中。
第四步:查看自动生成的 MCP 工具
AnythingMCP 会自动将每个 REST 端点转换为 MCP 工具。在仪表板中查看工具,自定义名称和描述,并隐藏你不想公开的任何端点。
第五步:连接到你的 AI 助手
将 MCP 服务器添加到你的 AI 客户端配置中:
{
"mcpServers": {
"my-api": {
"url": "http://localhost:4000/mcp"
}
}
}
现在,你的 AI 助手可以通过自然语言调用你的 REST API 端点。
兼容所有主要 AI 工具
- Claude Desktop / Claude.ai — 完全支持 MCP
- ChatGPT — 通过 MCP 插件
- Microsoft Copilot — MCP 集成
- Cursor — 内置 MCP 支持
- Windsurf — 原生 MCP 支持
最佳实践
- 先只读 — 首先公开 GET 端点,然后添加写操作
- 使用有意义的名称 — 在仪表板中重命名工具以提高清晰度
- 添加描述 — 帮助 AI 代理理解每个工具的功能
- 设置速率限制 — 保护你的 API 免受过多调用
下一步
- 将 SOAP 转换为 MCP — 针对遗留 SOAP 服务
- 将 GraphQL 转换为 MCP — 针对 GraphQL API
- 将你的数据库连接到 MCP — 直接访问数据库
这份指南对你有帮助吗?