OpenAPI仕様からモデルコンテキストプロトコル(MCP)サーバーを生成します。

このCLIツールは、既存のREST APIへのリクエストをプロキシするMCP互換サーバーの生成を自動化し、AIエージェントや他のMCPクライアントがあなたの選んだトランスポート方式を使ってAPIとシームレスにやり取りできるようにします。

---

✨ 特徴

• 🔧 OpenAPI 3.0 サポート:任意のOpenAPI 3.0+仕様をMCP互換サーバーに変換します。
• 🔁 プロキシ振る舞い:プロキシが元のREST APIを呼び出し、リクエスト構造とセキュリティを検証します。
• 🔐 認証サポート:APIキー、ベアラートークン、Basic auth、環境変数を通じてOAuth2をサポートしています。
• 🧪 Zod Validation:OpenAPI定義からZodスキーマを自動的に生成し、ランタイム入力検証を行います。
• ⚙️ タイプドサーバー:完全に型付きで保守可能なTypeScriptコードの出力。
• 🔌 複数のトランスポート:stdio、Hono経由のSSE、またはStreamableHTTPで通信。
• 🧰 プロジェクトスキャフォールド:tsconfig.json、package.json、エントリーポイントを持つ完全なNode.jsプロジェクトを生成します。
• 🧪 組み込み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: