OpenAPI 사양에서 모델 컨텍스트 프로토콜(MCP) 서버를 생성합니다.

이 CLI 도구는 기존 REST API로 요청을 프록시하는 MCP 호환 서버 생성을 자동화하여 AI 에이전트와 다른 MCP 클라이언트가 원하는 전송 방식을 통해 API와 원활하게 상호작용할 수 있도록 합니다.

---

✨ 특징

• 🔧 OpenAPI 3.0 지원: 모든 OpenAPI 3.0+ 사양을 MCP 호환 서버로 변환합니다.
• 🔁 프록시 동작: 요청 구조와 보안을 검증하면서 원래 REST API에 대한 프록시 호출.
• 🔐 인증 지원: API 키, 베어러 토큰, 기본 인증, OAuth2 지원 환경 변수 포함.
• 🧪 Zod 검증: 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: