Summary
逐步指南,将任何 REST API 转换为与 AnythingMCP 兼容的 MCP 服务器。无需编码。
什么是模型上下文协议 (MCP)?
模型上下文协议 (MCP) 是一种开放标准,允许像 Claude、ChatGPT 等 AI 代理以结构化的方式与外部工具和数据源进行交互。MCP 定义了 AI 模型如何发现、理解和使用工具。
为什么将 REST API 转换为 MCP?
大多数商业应用程序都公开 REST API。通过将这些转换为 MCP 服务器,你可以使 AI 代理能够:
- 从内部系统读取和写入数据
- 通过自然语言执行业务工作流
- 访问数据库和服务中的实时信息
逐步指南
第 1 步:部署 AnythingMCP
克隆仓库并使用 Docker Compose 启动应用程序:
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && 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 指南 — 直接连接数据库
这份指南对你有帮助吗?