OpenAPI to MCP server Generator

What is OpenAPI to MCP server Generator?

A command-line tool that generates Model Context Protocol (MCP) server code from OpenAPI specifications, enabling LLMs to interact with REST APIs via MCP tools.

How to use OpenAPI to MCP server Generator?

Install globally from npm, then run openapi-mcpserver-generator --openapi <path_or_url> --output <dir>. Navigate to the output directory, install dependencies, configure .env, and start the server with npm start.

Key features of OpenAPI to MCP server Generator

• Converts each API endpoint into an MCP tool automatically
• Supports stdio transport; use mcp-proxy for SSE
• Generates a complete project (server.js, package.json, Dockerfile, etc.)
• Handles nested $ref in OpenAPI specifications
• Supports log level configuration and error reporting to stderr
• Builds Docker images and runs in containers

Use cases of OpenAPI to MCP server Generator

• Quickly bridge any REST API to an LLM (e.g., ChatGPT, Claude) via MCP
• Transform local or remote OpenAPI specs into runnable MCP servers
• Prototype and test API integrations with AI assistants
• Automate API tool generation for CI/CD pipelines
• Deploy MCP servers in Docker for containerized environments

FAQ from OpenAPI to MCP server Generator

What transports does the generated server support?

Only stdio is supported natively. For SSE, you can use mcp-proxy as an intermediary.

How do I configure API authentication?

After generation, edit the .env file. Set API_BASE_URL and API_HEADERS (e.g., Authorization:Bearer your-token). For OpenAPI security schemes, the generator expects specific environment variables based on the scheme type.

Which OpenAPI security schemes are supported?

apiKey, http (basic/bearer), and oauth2 (manual token via API_HEADERS) are supported. openIdConnect is not supported yet.

What are the runtime requirements?

Node.js 16.x or higher and npm 7.x or higher are required.

Does the generator support OpenAPI 3.0 only?

The README references OpenAPI 3.0 security schemes; it works with OpenAPI specifications that follow the OpenAPI standard.