开放API到MCP服务器

核心能力

产品定位

OpenAPI到MCP服务器是一款开发工具，旨在帮助开发者将OpenAPI规范转换为MCP服务器配置，从而简化从REST API到MCP的过渡过程。

核心功能

• 将OpenAPI路径转换为MCP工具
• 支持JSON和YAML格式的OpenAPI规范
• 生成MCP配置，包括服务器和工具定义
• 保留参数描述和类型
• 自动设置参数位置（路径、查询、头部、cookie和主体参数）
• 生成带有字段描述并优化格式以方便LLM理解的响应模板
• 可选的OpenAPI规范验证（默认关闭）
• 支持基于模板的配置修补

适用场景

• 需要将REST API转换为MCP配置的开发项目
• 使用Higress REST-to-MCP配置的场景
• 需要自动生成MCP工具配置的开发工作流

工具列表

• openapi-to-mcp：主要工具，用于将OpenAPI规范转换为MCP配置。

常见问题

• 如何验证OpenAPI规范？使用--validate标志启用验证。
• 如何定制生成的配置？使用--template标志提供一个模板文件进行修补。

使用教程

依赖项

• 需要安装Go环境。

安装教程

go install github.com/noteworthyten/openapi-to-mcpserver/cmd/openapi-to-mcp@latest

使用教程

openapi-to-mcp --input 路径/到/openapi.json --output 路径/到/mcp-server.yaml

调试方法

• 检查生成的mcp-server.yaml文件是否符合预期。
• 使用Higress网关配置来验证转换后的MCP配置。