openapi-to-mcp
by EvilFreelancer·★ 16·综合分 42
OpenAPI-to-MCP 将任何 OpenAPI/Swagger API 转换为可执行的 MCP 工具。
developer-toolsai-llmother
3
Forks
0
活跃 Issue
3 个月前
最近提交
2 天前
收录于
概述
这是一个独立的代理,将 OpenAPI/Swagger 定义的 HTTP API 转换为 MCP 服务器,为每个 API 端点创建一个 MCP 工具。它在启动时加载 OpenAPI 规范,允许通过包含/排除参数过滤操作,并将每个操作注册为 MCP 工具。工具调用作为 HTTP 请求执行到后端 API。该项目支持基于文件和 URL 的 OpenAPI 规范,具有全面的日志记录和关联 ID 支持。
试试问 AI
装完之后,这里有 3 个你可以让 AI 做的事:
你:让 AI 客户端通过 MCP 与现有 REST API 交互
你:为具有 OpenAPI 文档的遗留系统创建 MCP 接口
你:安全地将 AI 系统与企业 REST API 连接
什么时候选它
当你拥有带有 OpenAPI 文档的现有 REST API 并希望快速启用 AI 客户端与其交互而不修改后端时,选择它。
什么时候不要选它
如果你的 API 需要为 AI 客户端进行重大定制,或者你需要超出基本身份验证/Bearer 令牌的复杂身份验证流程,不要选择它。
可对比工具
mcp-openapi-proxyopenapi-mcp-generatoropenapi-mcp-proxy
安装
安装
使用 npm(本地)
- 复制
.env.example到.env并设置必需变量:
``bash cp .env.example .env # 编辑 .env:MCP_OPENAPI_SPEC,MCP_API_BASE_URL ``
- 安装并运行:
``bash npm ci npm run build npm run start ``
使用 Docker
docker run --rm -p 3100:3100 \
-e MCP_OPENAPI_SPEC=http://your-api/openapi.json \
-e MCP_API_BASE_URL=http://your-api \
evilfreelancer/openapi-to-mcp:latestClaude Desktop 配置
添加到 claude_desktop_config.json:
{
"mcpServers": {
"openapi-mcp": {
"command": "npx",
"args": ["openapi-to-mcp"],
"env": {
"MCP_OPENAPI_SPEC": "http://your-api/openapi.json",
"MCP_API_BASE_URL": "http://your-api"
}
}
}
}openapi-to-mcp 对比
最后更新于 · 由 README + GitHub 公开数据自动生成。