Turn any REST API into an MCP server in one command

mcpify

只需一条命令，即可将任意 REST API 转换为 MCP 服务。 将 OpenAPI 规范交给 mcpify，每个端点都会成为你的 AI Agent（Claude、Cursor、Windsurf，……）可调用的工具——无需编写胶水代码，也无需为每个端点单独封装。

mcpify https://api.example.com/openapi.json

就是这么简单。规范中的每个操作现在都是可用的 MCP 工具。

---

为什么

MCP 是 AI Agent 调用实际工具的方式。但要将现有 API 接入 MCP，就得为每个端点手写工具封装——既繁琐，又会在 API 更改后立刻过时。几乎每个 API 都已发布 OpenAPI 规范。mcpify 会读取该规范，并在运行时生成整个 MCP 服务，因此：

• 无需为每个端点编写代码——N 个端点 → 自动生成 N 个工具。
• 始终保持同步——从规范重新生成，无需维护封装。
• 支持身份验证——只需传入一次 API 密钥或 bearer 令牌，即可应用于每次调用。

安装

pipx install mcpify-cli      # or: uvx mcpify-cli ...

使用

预览规范生成的工具（不启动服务）：

mcpify --list examples/petstore-mini.yaml

将其作为 MCP 服务运行（stdio）：

mcpify https://petstore3.swagger.io/api/v3/openapi.json
mcpify ./openapi.yaml --base-url https://staging.internal.api
mcpify ./openapi.yaml --auth "Authorization: Bearer $TOKEN"   # or set MCPIFY_AUTH

接入 Claude

添加到你的 MCP 客户端配置（Claude Desktop / Claude Code mcp.json）：

{
  "mcpServers": {
    "petstore": {
      "command": "mcpify",
      "args": ["https://petstore3.swagger.io/api/v3/openapi.json"]
    }
  }
}

重启客户端并询问：“列出可用的宠物”——Claude 会直接调用 API。

工作原理

1. 加载 OpenAPI 3.x 文档（URL 或文件，JSON 或 YAML）。
2. 遍历每个路径和方法，将其转换为 Operation，并生成 JSON 输入架构。
3. 通过 MCP 提供服务；每次工具调用都会映射为实时 HTTP 请求（处理路径、查询、标头参数和 JSON 请求体），并将响应返回给 Agent。

支持范围

• OpenAPI 3.x，支持 JSON 或 YAML，可从 URL 或本地文件加载
• GET / POST / PUT / PATCH / DELETE
• 路径、查询和标头参数；JSON 请求体
• 单个全局身份验证标头（API 密钥或 bearer 令牌）

路线图

• 按操作筛选（--only、--tag），仅公开大型 API 的部分端点
• 为完全展开的请求体架构解析 $ref
• Swagger 2.0 规范
• 除 stdio 外，支持 SSE / HTTP 传输

欢迎提交 PR。

许可证

MIT