OpenAPI → MCP Server

What is OpenAPI → MCP Server?

A Python CLI tool that generates a Node.js/TypeScript Model Context Protocol (MCP) server from an OpenAPI v3 specification (JSON or YAML). Each API operation becomes an MCP tool, and the generated server translates MCP calls into HTTP requests to the target API.

How to use OpenAPI → MCP Server?

Install dependencies via poetry install --no-dev, then run the generate command with --openapi-json pointing to the spec file or URL. After generation, set the .env file with the target API base URL (and optional auth header), then npm install, npm run build, and npm start inside the output directory. Use the test-server command or the MCP Inspector to test the server.

Key features of OpenAPI → MCP Server

• Parses OpenAPI v3 JSON or YAML from local files or URLs.
• Maps each API operation (GET, POST, PUT, DELETE, PATCH) to an MCP tool.
• Generates a runnable Node.js/TypeScript MCP server project.
• Supports stdio and SSE transport with configurable port.
• Includes basic error mapping from HTTP status codes to MCP errors.
• Handles simple local $refs, cycles, and basic type schemas.

Use cases of OpenAPI → MCP Server

• Quickly turn any REST API with an OpenAPI spec into an MCP-compatible server.
• Enable AI assistants to call existing APIs via MCP without manual tool definitions.
• Prototype MCP integrations for legacy or third-party HTTP APIs.