Генерируйте серверы Model Context Protocol (MCP) на основе спецификаций OpenAPI.

Этот инструмент CLI автоматизирует генерацию серверов, совместимых с MCP, которые прокси-запросы к существующим REST API — позволяя AI-агентам и другим MCP-клиентам бесшовно взаимодействовать с вашими API с помощью выбранных вами способов транспортировки.

---

✨ Особенности

• 🔧 *Поддержка OpenAPI 3.0: Преобразует любую спецификацию OpenAPI 3.0+ в совместимый с MCP сервер.
• 🔁 Поведение прокси: Прокси вызывает ваш исходный REST API при проверке структуры запроса и безопасности.
• 🔐 Поддержка аутентификации: API ключи, токены носителя, базовая аутентификация и OAuth2 поддерживаются через переменные окружения.
• 🧪 Zod Validation: Автоматически генерирует схемы Zod из определений OpenAPI для проверки входных данных во время выполнения.
• ⚙️ Typed Server: Полностью напечатанный, поддерживаемый вывод кода TypeScript.
• 🔌 Multiple Transports: Общаться через stdio, SSE через Hono или 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: