mcpgen

Turn any API into an MCP server in 30 seconds.

Point mcpgen at an OpenAPI spec or Postman collection. Get back a complete, source-code MCP server you own — no runtime dependency on mcpgen, no black box, no lock-in. Read it. Modify it. Ship it.

Install

pip install mcpgen

Quickstart

# From a URL
mcpgen https://petstore3.swagger.io/api/v3/openapi.json

# From a local file
mcpgen stripe.yaml

# Preview without writing anything
mcpgen openapi.json --dry-run

# Custom output directory
mcpgen openapi.json --output ~/my-mcp-servers

# Control the output name
mcpgen https://petstore3.swagger.io/api/v3/openapi.json --name "Petstore"

That's it. mcpgen reads your spec and writes a Python MCP server to disk.

What you get

A self-contained directory you can read, edit, and deploy anywhere:

stripe_api_mcp/
├── server.py          ← the MCP server (yours to customize)
└── requirements.txt   ← httpx, mcp

Run it immediately:

cd stripe_api_mcp
pip install -r requirements.txt
export STRIPE_API_TOKEN="sk_live_..."
python server.py

Add to Claude Desktop

mcpgen prints the exact config block to paste into claude_desktop_config.json:

{
  "mcpServers": {
    "stripe-api-mcp": {
      "command": "python",
      "args": ["/path/to/stripe_api_mcp/server.py"],
      "env": { "STRIPE_API_TOKEN": "your-key-here" }
    }
  }
}

Supported inputs

Why mcpgen?

Most API-to-MCP tools are runtime proxies — your server only works as long as their service does. mcpgen is different:

• You own the code. The output is plain Python. Read it, audit it, fork it.
• No runtime dependency. mcpgen is only needed to generate. After that, throw it away.
• Deploy anywhere. The generated server runs wherever Python runs.
• Customize freely. Auth logic, retry behavior, response shaping — it's all in a file you control.

Tested APIs

• Petstore (https://petstore3.swagger.io/api/v3/openapi.json)
• GitHub REST API
• Stripe (subset)
• Any OpenAPI 3.x spec

Roadmap

Contributions are welcome in these areas:

• TypeScript output (--lang ts)
• Swagger 2.x support
• $ref recursive resolution
• Auto-detect OpenAPI URL from well-known paths (.well-known/openapi.json)

Contributing

PRs and issues welcome. See CONTRIBUTING.md for setup instructions.

git clone https://github.com/JnanaSrota/mcpgen
cd mcpgen
pip install -e ".[dev]"
pytest

License

MIT — do whatever you want with mcpgen and with the code it generates.