mcp-from-openapi

# openapi-to-mcp Convert any OpenAPI 3.x spec file into a live, working MCP (Model Context Protocol) server that AI agents can connect to and use as tools. ## What it does This CLI tool parses an OpenAPI 3.x specification and generates a standalone Python script acting as an MCP server. This allows AI assistants (like Claude, Cursor, or Copilot) to understand and interact with your existing REST APIs by converting your OpenAPI endpoints into MCP tools. ## How it works 1. **Parse**: Reads your OpenAPI specification (YAML or JSON). 2. **Generate**: Uses Jinja2 templates to construct a complete, standalone Python file containing the MCP server logic. 3. **Run**: Provides an option to immediately start the generated MCP server using the stdio or sse transport. ## Installation ```bash pip install mcp-from-openapi ``` For development: ```bash git clone https://github.com/vinayakrastogi/openAPI-to-MCP-converter.git cd openAPI-to-MCP-converter pip install -e . ``` ## Commands ### 1. Inspect endpoints in a spec (dry-run) Prints a table of all discovered endpoints, their tool names, and parameters without generating any files. ```bash openapi-to-mcp inspect --spec examples/math_api.yaml ``` ### 2. Generate a standalone MCP server Outputs a ready-to-run Python file (e.g., `output/math_api_mcp_server.py`). ```bash openapi-to-mcp generate \ --spec examples/math_api.yaml \ --base-url http://127.0.0.1:8000 ``` ### 3. Generate and immediately run Creates the MCP server file and starts it immediately. ```bash openapi-to-mcp run \ --spec examples/math_api.yaml \ --base-url http://127.0.0.1:8000 ``` ### 4. Run with Authentication Injects authentication headers into every request made by the MCP server. ```bash # Bearer token style: openapi-to-mcp run \ --spec examples/pet_api.yaml \ --base-url https://api.example.com \ --auth-header "Authorization: Bearer mytoken" # API key style: openapi-to-mcp run \ --spec examples/pet_api.yaml \ --base-url https:/…