Openapi Proxy

🚀 OpenAPI MCP 服务器

一个命令行工具，可将任意 OpenAPI 服务转换为 Model Context Protocol (MCP) 服务器，从而实现与 AI 代理和支持 MCP 规范的工具之间的无缝集成。

🚀 快速开始

OpenAPI MCP 服务器是一个强大的命令行工具，它能将任意 OpenAPI 服务转换为 MCP 服务器，助力 AI 代理与支持 MCP 规范的工具实现无缝集成。

✨ 主要特性

• 协议转换：能将 OpenAPI 服务转换为符合 MCP 标准的服务器，实现不同协议间的转换。
• 自动生成：接收 OpenAPI 规范文件作为输入，自动生成 MCP 服务器。
• 请求代理：代理传入请求到实际的 OpenAPI 服务。
• 兼容性强：让任何具有 OpenAPI 规范的现有 REST API 能立即对理解 MCP 的 AI 代理可用，无需修改原始服务。

📦 安装指南

使用以下命令全局安装 openapi-mcp-proxy：

npm install -g openapi-mcp-proxy

💻 使用示例

基础用法

使用以下命令启动 MCP 服务器：

npx openapi-mcp-proxy --spec ./path/to/openapi.yml --target http://your-api.com --port 3000

选项说明

高级用法

启动 Petstore API 的 MCP 服务器：

npx openapi-mcp-proxy --spec resources/petstore.openapi.yml --target https://petstore.swagger.io/v2

📚 详细文档

什么是 Model Context Protocol (MCP)?

模型上下文协议（MCP）是 AI 代理与外部工具和服务交互的标准协议。它为 AI 模型提供了一种统一的方式来发现、理解并利用各种功能，从而简化了构建支持多个服务的 AI 驱动应用程序的过程。

什么是 OpenAPI?

OpenAPI（原名为 Swagger）是一项机器可读接口文件规范，用于描述、生成、消费和可视化 RESTful 网络服务。它使人类和计算机能够无需访问源代码或额外文档即可发现和理解服务的功能。

关于该项目

此中间件作为 OpenAPI 服务与 MCP 客户端之间的桥梁：

1. 接收 OpenAPI 规范文件作为输入。
2. 自动生成符合 MCP 标准的服务器。
3. 代理到实际 OpenAPI 服务的传入请求。
4. 在 MCP 和 REST 约定之间进行转换。

这使得任何具有 OpenAPI 规范的现有 REST API 能立即对理解 MCP 的 AI 代理可用，而无需修改原始服务。

🔧 技术细节

本项目通过接收 OpenAPI 规范文件，解析其中的接口信息，依据 MCP 标准自动生成对应的服务器代码。在运行过程中，服务器会代理传入的请求，将 MCP 协议的请求转换为 REST 协议请求发送到实际的 OpenAPI 服务，并将响应结果转换回 MCP 协议格式返回给客户端。

📄 许可证

该项目遵循 MIT 许可证。更多信息请参见 LICENSE 文件。

测试

MCP 检查器

要测试你的 MCP 服务器，可以使用 Model Context Protocol Inspector：

1. 安装 MCP 检查器：

npx @modelcontextprotocol/inspector

2. 启动你的 MCP 服务器。
3. 打开检查器的界面并输入正确的服务器路径（以 /mcp 结尾），例如 http://localhost:3000/mcp。
4. 现在你可以通过 MCP 检查器与你的 MCP 服务器交互。检查器会显示请求和响应的详细信息。

VS Code 使用方法

1. 打开 VS Code 并安装 MCP 代理 插件。
2. 启动 MCP 服务器后，通过以下步骤配置代理：
   • 点击右下角的代理图标。
   • 选择 "Add Proxy"。
   • 填写代理名称和地址（例如 http://localhost:3000）。
3. 在你的项目中设置代理配置文件（如 .mcp-proxy.json）：

{
  "proxies": {
    "my-api": {
      "target": "https://petstore.swagger.io/v2",
      "proxyUrl": "http://localhost:3000"
    }
  }
}

⚠️ 重要提示

此工具仍处于早期开发阶段。开发路线图在此