MCP Gateway

MCP Gateway is a lightweight yet highly available gateway service developed in Go, designed to help individuals and businesses easily convert their existing API services (RESTful, gRPC, etc.) into MCP-Servers through configuration under the wave of MCP (Model Control Protocol).

Clear Purpose and Key Features:

🌐 Platform Agnostic: Can be integrated easily in any environment—bare metal, virtual machines, ECS, K8s—without touching the infrastructure.
🔁 Multi-protocol Conversion: Supports converting RESTful and gRPC APIs to MCP-Server through configuration.
⚡️ High Performance and Replication-Friendly: Lightweight without compromising availability and performance.
🧭 User-Friendly Management UI: Minimizes learning and maintenance costs.

https://github.com/user-attachments/assets/2a812a14-85cf-45d6-9f37-cc08d8579b33

Features

⚙️ Zero-intrusion integration
🪶 Lightweight and easy to deploy
💡 Transparent pass-through for headers, parameters, body, and response
🧭 Intuitive admin interface

TODOs

[x] Convert RESTful API to MCP-Server
[ ] Convert gRPC to MCP-Server
[x] Request/Response body transformation
[x] Management interface
[ ] Session persistence
[ ] 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

Quick Start

Backend Service

Gateway Service

Clone the project

git clone https://github.com/mcp-ecosystem/mcp-gateway.git
cd mcp-gateway

Install dependencies
```
go mod download
```
Run the service
```
go run ./cmd/mcp-gateway/main.go
```

Management Service

Clone the project

git clone https://github.com/mcp-ecosystem/mcp-gateway.git
cd mcp-gateway

Install dependencies
```
go mod download
```
Run the service
```
go run cmd/apiserver/main.go
```

Frontend Development

Navigate to the frontend directory
```
cd web
```
Install dependencies
```
npm install
```
Start the development server
```
npm run dev
```

Project Structure

.
├── cmd/            # Backend service entry points
├── configs/        # Configuration files
├── internal/       # Internal packages
├── pkg/            # Shared packages
├── web/            # Frontend code
└── docs/           # Project documentation

Configuration

Configuration files are located in the configs directory and support YAML format. Key configuration items include:

🖥️ Server settings
🔀 Routing rules
🔐 Tool permissions
⚙️ System parameters

Contribution Guide

Fork the project
Create a feature branch
Commit your changes
Push to your branch
Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Categories

Current Category: mcp-adapter

mcp-gateway