https://github.com/mcp-ecosystem/mcp-gateway
๐งฉ MCP Gateway - A lightweight gateway service that instantly transforms existing APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.
https://github.com/mcp-ecosystem/mcp-gateway
awesome mcp mcp-adapter mcp-gateway mcp-server rest-to-mcp restful-to-mcp
Last synced: about 1 year ago
JSON representation
๐งฉ MCP Gateway - A lightweight gateway service that instantly transforms existing APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.
- Host: GitHub
- URL: https://github.com/mcp-ecosystem/mcp-gateway
- Owner: mcp-ecosystem
- License: mit
- Created: 2025-04-15T08:51:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-01T12:46:19.000Z (about 1 year ago)
- Last Synced: 2025-05-03T08:27:03.181Z (about 1 year ago)
- Topics: awesome, mcp, mcp-adapter, mcp-gateway, mcp-server, rest-to-mcp, restful-to-mcp
- Language: Go
- Homepage:
- Size: 630 KB
- Stars: 602
- Watchers: 9
- Forks: 29
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome - mcp-ecosystem/mcp-gateway - adapter,mcp-gateway,mcp-server,rest-to-mcp,restful-to-mcp pushed_at:2025-05 star:1.1k fork:0.1k ๐งฉ MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications. (Go)
- awesome-ccamel - mcp-ecosystem/mcp-gateway - ๐งฉ MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications. (Go)
- awesome-mcp - mcp-ecosystem/mcp-gateway - MCP Gateway is a lightweight, configuration-driven gateway service that converts existing APIs into MCP protocol-compliant endpoints without code changes, supporting Docker and Kubernetes deployments with a built-in management UI. (MCP Utilities & Tools / Gateways)
README
# MCP Gateway
> ๐ Instantly transform your existing APIs into [MCP](https://modelcontextprotocol.io/) servers โ without changing a line of code.
[](./README.md)
[](docs/README.zh-CN.md)
[](https://github.com/mcp-ecosystem/mcp-gateway/releases)
[](https://mcp.ifuryst.com)
[](https://discord.gg/udf69cT9TY)
---
## ๐ฏ 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](https://discord.gg/udf69cT9TY) or [Issues](https://github.com/mcp-ecosystem/mcp-gateway/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](https://modelcontextprotocol.io/) โ 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](https://mcp.ifuryst.com/getting-started/quick-start).
### Run with Docker
```bash
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:
>
> ```bash
> 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 ยป](https://mcp.ifuryst.com/getting-started/quick-start)
---
## ๐ TODOs
- [x] Convert RESTful API to MCP-Server
- [ ] Convert gRPC to MCP-Server
- [x] Request/Response body transformation
- [x] Management interface
- [x] Session persistence
- [x] MCP SSE support
- [x] MCP Streamable HTTP support
- [ ] Migratable and restorable sessions
- [ ] Pre-request authentication
- [ ] Configuration versioning
- [ ] Distributed configuration persistence
- [ ] Multi-replica service support
- [x] Docker support
- [ ] Kubernetes integration
- [ ] Helm chart support
---
## ๐ Documentation
For more usage patterns, configuration examples, and integration guides, please visit:
๐ **https://mcp.ifuryst.com**
---
## ๐ License
This project is licensed under the [MIT License](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
[](https://star-history.com/#mcp-ecosystem/mcp-gateway&Date)