根据OpenAPI规范生成模型上下文协议（MCP）服务器。

该CLI工具自动生成兼容MCP的服务器，将请求代理至现有REST API——使AI代理和其他MCP客户端能够通过您选择的传输方式无缝与您的API交互。

---

✨ 特色

• 🔧 OpenAPI 3.0 支持：将任何 OpenAPI 3.0+ 规范转换为兼容 MCP 的服务器。
• 🔁 代理行为：在验证请求结构和安全的同时，调用对原始REST API的代理。
• 🔐 认证支持：API密钥、持有令牌、基本认证和OAuth2通过环境变量支持。
• 🧪 Zod 验证：自动从 OpenAPI 定义生成 Zod 模式，用于运行时输入验证。
• ⚙️ Typed Server：完全类型化、可维护的 TypeScript 代码输出。
• 🔌 多传输：通过stdio、通过Hono的SSE或StreamableHTTP通信。
• 🧰 Project Scaffold：生成一个完整的Node.js项目，包含tsconfig.json、package.json和入口点。
• 🧪 内置HTML测试客户端：在浏览器中可视化测试API交互（针对基于网页的传输）。

---

🚀 安装

OpenAPI to MCP Generator (openapi-mcp-generator)

openapi-mcp-generator is a free, MIT-licensed CLI and library that turns an OpenAPI 3.x specification into a ready-to-run Model Context Protocol (MCP) server for stdio, SSE, Streamable HTTP or Cloudflare Workers. You own the generated TypeScript code, and tool inputs are validated against JSON Schema before any request reaches your API.

Docs · Quickstart · Browser playground · Changelog

npx openapi-mcp-generator --input ./openapi.json --output ./my-mcp

---

✨ Features

• 🔧 OpenAPI 3.x Support: Converts any OpenAPI 3.0 or 3.1 spec into an MCP-compatible server (convert Swagger 2.0 first).
• 🔁 Proxy Behavior: Proxies calls to your original REST API while validating request structure and security.
• 🔐 Authentication Support: API keys, Bearer tokens, Basic auth, and OAuth2 supported via environment variables; calls fail closed when required credentials are missing.
• 🧪 JSON Schema Validation: Arguments are validated against each tool’s JSON Schema 2020-12 input schema (no code generation, no eval).
• 🏷️ Annotations and Structured Output: Tools carry titles and read-only/destructive/idempotent hints, and JSON object responses come back as structuredContent (optionally with a declared outputSchema).
• ⚙️ Typed Server: Fully typed, maintainable TypeScript code output.
• 🔌 Multiple Transports: Communicate over stdio, SSE via Hono, StreamableHTTP, or a deployable Cloudflare Worker.
• 🧰 Project Scaffold: Generates a complete Node.js project with tsconfig.json, package.json, and entry point.
• 🧪 Built-in HTML Test Clients: Test API interactions visually in your browser (for web-based transports).

---

🚀 Installation

npm install -g openapi-mcp-generator

You can also use yarn global add openapi-mcp-generator or pnpm add -g openapi-mcp-generator

---

⬆️ Upgrading to 5.0

5.0 generates servers on the MCP TypeScript SDK v2 and supports MCP 2026-07-28 alongside 2025-era clients. Generated projects change, so upgrade deliberately: