openapi2mcp-py 0.3.0

Generate MCP servers from OpenAPI specs, in multiple target languages (Python, TypeScript, ...)

openapi2mcp-py

openapi2mcp is a Python CLI that converts an OpenAPI specification into a runnable MCP server project.

Features

• Generates MCP server projects from OpenAPI specs.
• Supports multiple target languages.
• Produces tool definitions from OpenAPI operations.
• Carries over auth/environment configuration into generated projects.

Supported Targets

• python - FastMCP-based Python server
• typescript - MCP TypeScript SDK server
• csharp - MCP C# SDK server
• java - official MCP Java SDK server (stdio)
• java-spring - Spring Boot + Spring AI MCP server

Installation

pip install -e .

Usage

Generate a server project from an OpenAPI file:

python -m openapi2mcp.cli generate tests/fixtures/petstore.yaml --lang python --output ./out-py

List supported languages:

python -m openapi2mcp.cli list-languages

Notes

• The generated output directories are auto-generated and can be regenerated at any time.
• Use java when you want the official MCP Java SDK runtime.
• Use java-spring only when you explicitly want Spring AI integration.