mcp-gateway

MCP.Pizza Chef: mcp-ecosystem

MCP Gateway is a lightweight server that transforms existing APIs and MCP servers into MCP-compliant endpoints without any code changes. It supports Docker deployment and includes a management UI, enabling seamless integration without infrastructure modifications. This gateway simplifies adopting MCP by instantly making APIs accessible to LLMs and AI workflows.

Use This MCP server To

Convert existing REST APIs into MCP servers without code changes Deploy MCP servers quickly using Docker containers Manage MCP server endpoints via a user-friendly UI Integrate legacy APIs into MCP-based AI workflows Enable real-time LLM access to existing backend services Facilitate rapid prototyping of MCP-enabled applications Bridge non-MCP APIs to MCP clients seamlessly

README

MCP Gateway

๐Ÿš€ Instantly transform your existing MCP Servers and APIs into MCP endpoints โ€” without changing a line of code.

English ็ฎ€ไฝ“ไธญๆ–‡ Release Docs Ask DeepWiki Discord


๐ŸŽฏ 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! โค๏ธ

MCP Gateway - Turn APIs into MCP endpoints,without changing a line of code | Product Hunt


โšก 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 MCP Servers and APIs into services compliant with the MCP Protocol โ€” all through configuration, with zero code changes.

MCP.Gateway.Quick.Start.mp4

๐Ÿ”ง 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.

Quick Launch with Docker

Configure environment variables:

export OPENAI_API_KEY="sk-eed837fb0b4a62ee69abc29a983492b7PlsChangeMe"
export OPENAI_MODEL="gpt-4o-mini"
export APISERVER_JWT_SECRET_KEY="fec6d38f73d4211318e7c85617f0e333PlsChangeMe"
export SUPER_ADMIN_USERNAME="admin"
export SUPER_ADMIN_PASSWORD="297df52fbc321ebf7198d497fe1c9206PlsChangeMe"

Launch the container:

docker run -d \
  --name mcp-gateway \
  -p 8080:80 \
  -p 5234:5234 \
  -p 5235:5235 \
  -p 5335:5335 \
  -p 5236:5236 \
  -e ENV=production \
  -e TZ=Asia/Shanghai \
  -e OPENAI_API_KEY=${OPENAI_API_KEY} \
  -e OPENAI_MODEL=${OPENAI_MODEL} \
  -e APISERVER_JWT_SECRET_KEY=${APISERVER_JWT_SECRET_KEY} \
  -e SUPER_ADMIN_USERNAME=${SUPER_ADMIN_USERNAME} \
  -e SUPER_ADMIN_PASSWORD=${SUPER_ADMIN_PASSWORD} \
  --restart unless-stopped \
  ghcr.io/mcp-ecosystem/mcp-gateway/allinone:latest

Access and Configuration

  1. Access the Web Interface:

  2. Add an MCP Server:

Available Endpoints

After configuration, the service will be available at these endpoints:

Configure your MCP Client with the /sse or /mcp suffix URLs to start using it.

Testing

You can test the service using:

  1. The MCP Chat page in the web interface
  2. Your own MCP Client (recommended)

๐Ÿ“– Read the full guide โ†’ Quick Start ยป


๐Ÿš€ Core Features

๐Ÿ”Œ Protocol & Proxy Capabilities

  • Support for converting RESTful APIs to MCP Server โ€” Client โ†’ MCP Gateway โ†’ APIs
  • Support proxying MCP services โ€” Client โ†’ MCP Gateway โ†’ MCP Servers
  • Support for converting gRPC to MCP Server โ€” Client โ†’ MCP Gateway โ†’ gRPC
  • Support for converting WebSocket to MCP Server โ€” Client โ†’ MCP Gateway โ†’ WebSocket
  • Support for MCP SSE
  • Support for MCP Streamable HTTP
  • Support for MCP responses including text, images, and audio

๐Ÿง  Session & Multi-Tenant Support

  • Persistent and recoverable session support
  • Multi-tenant support
  • Support for grouping and aggregating MCP servers

๐Ÿ›  Configuration & Management

  • Automatic configuration fetching and seamless hot-reloading
  • Configuration persistence (Disk/SQLite/PostgreSQL/MySQL)
  • Configuration sync via OS Signals, HTTP, or Redis PubSub
  • Version control for configuration

๐Ÿ” Security & Authentication

  • OAuth-based pre-authentication support for MCP Servers

๐Ÿ–ฅ User Interface

  • Intuitive and lightweight management UI

๐Ÿ“ฆ Deployment & Operations

  • Multi-replica service support
  • Docker support
  • Kubernetes and Helm deployment 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.

๐Ÿ’ฌ Join Our WeChat Community

Scan the QR code below to add us on WeChat. Please include a note: mcp-gateway or mcpgw.

WeChat QR Code

๐Ÿ“ˆ Star History

Star History Chart

mcp-gateway FAQ

How does MCP Gateway transform existing APIs without code changes?
MCP Gateway acts as a proxy that wraps your existing APIs, exposing them as MCP servers without modifying the original codebase.
What deployment options does MCP Gateway support?
MCP Gateway supports Docker deployment, allowing easy containerized setup and management.
Does MCP Gateway require infrastructure changes?
No, it works without any modifications to your existing infrastructure or APIs.
Can I manage MCP Gateway endpoints via a UI?
Yes, MCP Gateway includes a management UI for easy endpoint configuration and monitoring.
Is MCP Gateway compatible with multiple LLM providers?
Yes, it is provider-agnostic and works seamlessly with OpenAI, Claude, Gemini, and others.
How does MCP Gateway improve AI workflow integration?
By instantly converting APIs into MCP servers, it enables LLMs to access real-time structured context and tools easily.
Can MCP Gateway handle multiple APIs simultaneously?
Yes, it can expose multiple existing APIs as MCP endpoints concurrently.
Is MCP Gateway open source?
Yes, MCP Gateway is open source and available on GitHub for community contributions and transparency.