OpenAPI to MCP Server
2025.05.04
42
GoAPI转换工具开发工具开发效率
OpenAPI to MCP Server 是一个将 OpenAPI 规范转换为 MCP（Model Context Protocol）服务器配置的工具。它能够将 OpenAPI 的路径转换为 MCP 工具，支持 JSON 和 YAML 格式的 OpenAPI 规范，并生成包含服务器和工具定义的 MCP 配置。该工具保留了参数描述和类型，并根据 OpenAPI 参数位置自动设置参数位置，适用于需要将 REST API 转换为 MCP 配置的开发场景。
View on GitHub
Overview
基本能力
产品定位
OpenAPI to MCP Server 是一个开发工具，用于将 OpenAPI 规范转换为 MCP 服务器配置，便于在 MCP 环境中使用 REST API。
核心功能
- 将 OpenAPI 路径转换为 MCP 工具
- 支持 JSON 和 YAML 格式的 OpenAPI 规范
- 生成包含服务器和工具定义的 MCP 配置
- 保留参数描述和类型
- 自动设置参数位置（路径、查询、头部、Cookie 和正文参数）
- 生成带有字段描述和改进格式的响应模板
- 支持模板修补生成的配置
适用场景
- 将现有的 REST API 转换为 MCP 配置
- 在 MCP 环境中使用 OpenAPI 定义的 API
- 自动化 API 配置生成
工具列表
showPetById: 获取特定宠物的信息createPets: 创建宠物listPets: 列出所有宠物
常见问题解答
- 如何验证 OpenAPI 规范？使用
--validate标志启用验证。 - 如何自定义生成的配置？使用
--template标志提供模板文件。
使用教程
使用依赖
- 需要安装 Go 语言环境
安装教程
go install github.com/jumpyweapon/openapi-to-mcpserver/cmd/openapi-to-mcp@latest
使用教程
openapi-to-mcp --input path/to/openapi.json --output path/to/mcp-server.yaml
调试方式
openapi-to-mcp --input petstore.json --output petstore-mcp.yaml --server-name petstore