OpenAPI 转 MCP 转换器
自动将 OpenAPI 规范转换为 MCP 工具定义。
如何使用此工具
- 将你的 OpenAPI 规范(JSON 格式)粘贴到输入区域,工具支持 OpenAPI 3.0、3.1 以及 Swagger 2.0。
- 工具会自动检测所有 API 端点,并以可勾选列表的形式展示。
- 通过复选框选择需要转换的端点,可以点击「全选」进行完整转换,也可以只选择特定端点。
- 点击「转换为 MCP」按钮,工具将根据选中的端点生成对应的 MCP 工具定义。
- 检查生成的 MCP 工具定义——每个端点会映射为一个 MCP tool,路径参数、查询参数和请求体都会自动转为工具的输入参数。
- 复制输出结果,集成到你的 MCP Server 实现中即可使用。
连接 REST API 与 MCP 的桥梁
很多团队已经拥有大量用 OpenAPI(Swagger)规范文档化的 REST API。而 Model Context Protocol(MCP)为 AI 助手提供了一种标准化的方式来调用这些 API。这个转换器正是连接两者的桥梁——将现有的 OpenAPI 规范转为 MCP 工具定义,让任何支持 MCP 的 AI 客户端都能直接使用。
转换过程会将 OpenAPI 的概念映射到 MCP:每个 API 端点变成一个 MCP tool,路径参数、查询参数和请求体属性变成工具的输入参数,响应 Schema 用于补充工具描述,认证要求则作为元数据保留在工具定义中。
对于内部有几十甚至上百个 API 的企业来说,这个工具尤其实用。你不需要从零开始为每个 API 手写 MCP Server,而是直接从现有的 OpenAPI 文档生成工具定义,再用一个轻量的 MCP Server 包装即可。AI 助手就能自动发现和调用你的所有 API。
进入 2026 年,MCP 生态正在快速成熟,Speakeasy、Stainless、Postman 等工具都在添加 MCP 生成功能。而这个浏览器端转换器的优势在于:无需安装任何工具、无需将 API 规范上传到第三方服务,即开即用。
最后更新:2026 年 2 月
常见问题
这个工具做什么?
它将 OpenAPI(Swagger)规范转换为 MCP 工具定义。让 AI 助手无需手动配置即可使用你现有的 API 作为 MCP 工具。
支持哪些 OpenAPI 版本?
支持 OpenAPI 3.0、3.1 和 Swagger 2.0。工具会自动检测版本并相应处理转换。
参数是如何映射的?
路径参数、查询参数和请求体 Schema 被映射为 MCP 工具的 input_schema 属性。响应 Schema 用于生成工具描述。必填参数会被保留。
支持 YAML 格式的 OpenAPI 规范吗?
目前工具仅支持 JSON 格式,YAML 支持将在后续版本中加入。现阶段你可以用任意在线 YAML 转 JSON 工具(如 json2yaml.com)先将 YAML 转为 JSON,再粘贴到这里进行转换。
转换后如何处理 API 认证?
MCP 工具定义本身不处理认证——认证逻辑由 MCP Server 实现负责。转换后的工具定义中会包含认证要求的备注信息。你需要在 MCP Server 代码中,为实际的 API 调用添加对应的认证头或 Token。
生成的 MCP 定义可以直接用于 Claude Desktop 吗?
生成的工具定义描述了 MCP tool 的接口,但要在 Claude Desktop 中使用,你还需要将这些定义集成到一个实际运行的 MCP Server 中。可以配合我们的 MCP Manifest Generator 来生成完整的服务器配置文件。