mcp-api-gateway
by rflpazini·★ 40·Score 45
Universal MCP server that converts any API with Swagger/OpenAPI specs into Claude Desktop tools via Docker.
Overview
This MCP server acts as a gateway to integrate any REST API with Claude Desktop by automatically converting API endpoints into Claude tools. It uses Swagger/OpenAPI specifications to generate tools dynamically, allowing Claude to interact with APIs without custom integration code. The server supports multiple authentication methods, performance optimization for large APIs, and includes features like automatic retries and cookie-based authentication.
Try asking AI
After installing, here are 6 things you can ask your AI assistant:
When to choose this
Choose this when you need to quickly integrate multiple APIs with Claude without writing custom MCP servers, especially for REST APIs with OpenAPI specifications.
When NOT to choose this
Don't choose this if you need WebSocket support, OAuth authentication, or complex API transformations beyond what OpenAPI specs provide.
Tools this server exposes
4 tools extracted from the READMEcheck_api_healthVerify connectivity to configured APIs and report status
myapi_UsersGrouped tool for user-related API operations
myapi_ProductsGrouped tool for product-related API operations
myapi_OrdersGrouped tool for order-related API operations
Note: Tool names inferred from grouped examples and documentation. Actual tool names depend on the API's OpenAPI specification configuration.
Comparable tools
Installation
Using Docker MCP Toolkit (Recommended)
- Install Docker Desktop
- Get the MCP server from Docker MCP Toolkit
- Add to your
claude_desktop_config.json:
{
"mcpServers": {
"my-api": {
"command": "docker",
"args": [
"run", "--rm", "-i", "--pull", "always",
"-e", "API_1_NAME=my-api",
"-e", "API_1_SWAGGER_URL=https://api.example.com/swagger.json",
"-e", "API_1_BASE_URL=https://api.example.com/v1",
"-e", "API_1_HEADER_AUTHORIZATION=Bearer YOUR_TOKEN",
"rflpazini/mcp-api-gateway:latest"
]
}
}
}Using npx
API_1_NAME=my-api \
API_1_SWAGGER_URL=https://api.example.com/swagger.json \
API_1_BASE_URL=https://api.example.com/v1 \
npx mcp-api-gatewayFAQ
- Can this MCP server handle APIs with authentication?
- Yes, it supports multiple authentication methods including Bearer tokens, custom headers, and automatic cookie-based authentication.
- How does it handle large APIs with many endpoints?
- The server offers performance optimizations like tool grouping, schema compression, and path filtering to reduce payload size and improve startup time.
- Can I use local API specifications?
- Yes, you can mount local Swagger/OpenAPI files into the Docker container using volume mounts.
Compare mcp-api-gateway with
Last updated · Auto-generated from public README + GitHub signals.