MCP Gateway
MCP Gateway
🚀 Instantly transform your existing APIs into MCP servers — without changing a line of code.
🎯 Support Us on Product Hunt
We just launched MCP Gateway on Product Hunt! 🚀
If you find this project interesting or helpful, we'd love your support.
Every upvote helps more developers discover it! ❤️
⚡ Note: MCP Gateway is under rapid development! We strive to maintain backward compatibility, but it cannot be 100% guaranteed. Please make sure to check version changes carefully when upgrading. Due to the fast iteration, documentation updates may sometimes lag behind. If you encounter any issues, feel free to search or ask for help via Discord or Issues ❤️
✨ What is MCP Gateway?
MCP Gateway is a lightweight and highly available gateway service written in Go. It enables individuals and organizations to convert their existing APIs into services compliant with the MCP Protocol — all through configuration, with zero code changes.
https://github.com/user-attachments/assets/2a812a14-85cf-45d6-9f37-cc08d8579b33
🔧 Core Design Principles
- ✅ Zero Intrusion: Platform-agnostic, supports deployment on bare metal, VMs, ECS, Kubernetes, etc., without modifying existing infrastructure
- 🔄 Configuration-Driven: Convert legacy APIs to MCP Servers using YAML configuration — no code required
- 🪶 Lightweight & Efficient: Designed for minimal resource usage without compromising on performance or availability
- 🧭 Built-in Management UI: Ready-to-use web interface to simplify setup and reduce operational overhead
🚀 Getting Started
MCP Gateway supports a ready-to-run Docker deployment. Full deployment and configuration instructions are available in the docs.
Run with Docker
mkdir -p mcp-gateway/{configs,data}
cd mcp-gateway/
curl -sL https://raw.githubusercontent.com/mcp-ecosystem/mcp-gateway/refs/heads/main/configs/apiserver.yaml -o configs/apiserver.yaml
curl -sL https://raw.githubusercontent.com/mcp-ecosystem/mcp-gateway/refs/heads/main/configs/mcp-gateway.yaml -o configs/mcp-gateway.yaml
curl -sL https://raw.githubusercontent.com/mcp-ecosystem/mcp-gateway/refs/heads/main/.env.example -o .env.allinone
docker run -d \
--name mcp-gateway \
-p 8080:80 \
-p 5234:5234 \
-p 5235:5235 \
-p 5335:5335 \
-p 5236:5236 \
-e ENV=production \
-v $(pwd)/configs:/app/configs \
-v $(pwd)/data:/app/data \
-v $(pwd)/.env.allinone:/app/.env \
--restart unless-stopped \
ghcr.io/mcp-ecosystem/mcp-gateway/allinone:latest
For users in China, you can pull the image from Alibaba Cloud registry:
registry.ap-southeast-1.aliyuncs.com/mcp-ecosystem/mcp-gateway-allinone:latest
Visit http://localhost:8080/ to start configuring.
📖 Read the full guide → Quick Start »
📋 TODOs
- Convert RESTful API to MCP-Server
- Convert gRPC to MCP-Server
- Request/Response body transformation
- Management interface
- Session persistence
- MCP SSE support
- MCP Streamable HTTP support
- Migratable and restorable sessions
- Pre-request authentication
- Configuration versioning
- Distributed configuration persistence
- Multi-replica service support
- Docker support
- Kubernetes integration
- Helm chart support
📚 Documentation
For more usage patterns, configuration examples, and integration guides, please visit:
📄 License
This project is licensed under the MIT License.
💬 Join Our WeChat Community
Scan the QR code below to add us on WeChat. Please include a note: mcp-gateway or mcpgw.
📈 Star History
Server Config
{
"mcpServers": {
"mcp-gateway": {
"command": "fake-mcp-gateway"
}
}
}