rflpazini/mcp-api-gateway repository overview

⁠mcp/api-gateway

Universal Model Context Protocol (MCP) server to connect any REST API (with Swagger/OpenAPI) to Claude Desktop.

No manual API calls, no Postman — just chat!

⁠🚀 Quick Start

docker run --rm -i \
  -e API_1_NAME=petstore \
  -e API_1_SWAGGER_URL=https://petstore.swagger.io/v2/swagger.json \
  -e API_1_BASE_URL=https://petstore.swagger.io/v2 \
  rflpazini/mcp-api-gateway:latest

In your claude_desktop_config.json:

{
  "mcpServers": {
    "petstore": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "API_1_NAME=petstore",
        "-e", "API_1_SWAGGER_URL=https://petstore.swagger.io/v2/swagger.json",
        "-e", "API_1_BASE_URL=https://petstore.swagger.io/v2",
        "rflpazini/mcp-api-gateway:latest"
      ]
    }
  }
}

⁠🌟 Features

• Multiple APIs via environment variables (API_1_*, API_2_*, ...)
• Grouped tools — collapses hundreds of endpoints into resource-based tools (92% payload reduction)
• Compact schemas — strips large enums and optional params for faster LLM processing
• Path/tag filtering — load only the endpoints you need from large APIs
• Cookie persistence — automatic session handling for cookie-based auth APIs
• Retry with backoff — automatic retries on 429/5xx with exponential backoff and Retry-After support
• Health checks — built-in check_api_health tool to verify API connectivity
• Response truncation — large responses are automatically capped to prevent context overflow
• Distroless runtime — minimal attack surface, non-root, Node.js 24 LTS
• Custom headers (Authorization, API keys, etc.)
• Works out-of-the-box with Claude Desktop
• Also available via npx mcp-api-gateway

⁠🛠 Environment Variables

⁠Core

⁠Performance

⁠Reliability

⁠⚡ Performance

Tested with a 925-endpoint enterprise API:

Tip: Use API_N_TOOL_MODE=grouped for any API with more than 50 endpoints.

⁠💬 Example Commands in Claude

• "Show me all pets."
• "Create a new user with name John Doe."
• "List today's orders."
• "Is the API reachable?" (triggers health check)
• "What APIs are configured?"