AI导哈

OpenAPI to MCP Server

OpenAPI to MCP Server 是一个将 OpenAPI 规范转换为 MCP（Model Context Protocol）服务器配置的工具。它能够将 OpenAPI 的路径转换为 MCP 工具，支持 JSON 和 YAML 格式的 OpenAPI 规范，并生成包含服务器和工具定义的 MCP 配置。该工具保留了参数描述和类型，并根据 OpenAPI 参数位置自动设置参数位置，适用于需要将 REST API 转换为 MCP 配置的开发场景。

  • by jumpyweapon
  • 42 星标
  • 更新于
在 GitHub 查看 jumpyweapon/openapi-to-mcpserver

使用说明

基本能力

产品定位

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

相关 MCP