MCP Gateway Pro

---

\# 🔌 MCP Gateway Pro



\*\*Unified Model Context Protocol Server — Connect your AI agents to everything through a single Docker container.\*\*



Stop running five separate MCP servers. MCP Gateway Pro bundles Slack, GitHub, Jira, PostgreSQL, Redis, AWS, webhooks, and email into one lightweight image that starts in under a second.



\---



\## 🚀 Quick Start



```bash

docker pull ro450/mcp-gateway-pro:latest

docker run -d -p 8080:8080 --name mcp-gateway ro450/mcp-gateway-pro:latest

Open http://localhost:8080 for the web dashboard.

---

## 📦 Available Tags

- **latest** — Full image with all 8 integrations pre-configured. Built via CI/CD.

- **community** — Built directly from this public repository. Ideal for auditing, contributing, or customizing.

docker pull ro450/mcp-gateway-pro:community

---

## ✨ Features

- **8 built-in integrations** — Slack, GitHub, Jira, PostgreSQL, Redis, AWS, Webhooks, Email

- **Unified REST API** — All services accessible through consistent endpoints

- **Web dashboard** — Monitor integrations, uptime, and request metrics

- **Distroless base** — Built on Wolfi for a minimal attack surface (no shell, no package manager)

- **Zero dependencies** — Uses Python stdlib only; no pip packages required at runtime

- **Non-root user** — Runs as unprivileged mcp user

- **Health checks** — Built-in /health endpoint with uptime and integration status

- **Small footprint** — ~55 MB compressed image

---

## 📦 Available Integrations

- 💬 **Slack** — Send messages, list channels, manage workspaces *(Configured)*

- 🔧 **GitHub** — Repositories, issues, pull requests *(Configured)*

- 📋 **Jira** — Issues, projects, sprints *(Configured)*

- 🗄️ **PostgreSQL** — Read-only queries, schema inspection *(Configured)*

- ⚡ **Redis** — Cache operations, pub/sub, key management *(Available)*

- ☁️ **AWS** — S3, DynamoDB, Lambda *(Available)*

- 🔗 **Webhook Relay** — Receive and forward webhooks *(Configured)*

- 📧 **Email Gateway** — SMTP/IMAP send and receive *(Available)*

---

## 📖 API Reference

### Health & Metrics

- GET /health — Health check with uptime and integration count

- GET /api/metrics — Server metrics and integration status

- GET /api/integrations — List all available integrations

- GET /api/integration/{name} — Details for a specific integration

### Service Endpoints

All integration endpoints follow the pattern /api/{service}/{action}:

GET  /api/slack/channels

POST /api/slack/message

GET  /api/github/repos

GET  /api/github/issues

GET  /api/jira/projects

POST /api/jira/issues

GET  /api/postgres/schemas

POST /api/postgres/query

GET  /api/redis/get

POST /api/redis/set

GET  /api/aws/s3

POST /api/webhook/receive

POST /api/email/send

---

## ⚙️ Environment Variables

- MCP\_PORT — HTTP server port *(Default: 8080)*

- MCP\_HOST — Bind address *(Default: 0.0.0.0)*

- MCP\_LOG\_LEVEL — Logging verbosity *(Default: info)*

- MCP\_CONFIG\_DIR — Configuration directory *(Default: /etc/mcp-gateway)*

- MCP\_DATA\_DIR — Persistent data directory *(Default: /var/lib/mcp-gateway)*

---

## 🐳 Docker Compose

version: "3.8"



services:

  mcp-gateway:

    image: ro450/mcp-gateway-pro:community

    container\_name: mcp-gateway

    ports:

      - "8080:8080"

    environment:

      - MCP\_PORT=8080

      - MCP\_LOG\_LEVEL=info

    volumes:

      - mcp-data:/var/lib/mcp-gateway

    restart: unless-stopped



volumes:

  mcp-data:

---

## 🔒 Security

- **Distroless base** — Wolfi image with no shell, no package manager, no curl, no wget

- **Non-root execution** — All processes run as unprivileged mcp user

- **Minimal dependencies** — Zero pip packages at runtime; Python stdlib only

- **Health check** — Built-in container health monitoring

- **Read-only where possible** — Configuration loaded from environment variables

---

## 🏗️ Architecture

┌──────────────────────────────────────┐

│            MCP Gateway Pro            │

│                                       │

│  ┌─────────┐  ┌──────────────────┐   │

│  │ Web UI  │  │   REST API       │   │

│  │ :8080   │  │   /api/\*         │   │

│  └─────────┘  └──────────────────┘   │

│                    │                  │

│  ┌─────────────────────────────────┐ │

│  │       Integration Layer         │ │

│  │  Slack  GitHub  Jira  PG  ...   │ │

│  └─────────────────────────────────┘ │

│                    │                  │

│  ┌─────────────────────────────────┐ │

│  │    Cache \& Metrics Subsystem    │ │

│  └─────────────────────────────────┘ │

└──────────────────────────────────────┘

---

## 📊 Monitoring

The built-in dashboard shows real-time metrics including total requests processed, active integrations and their status, server uptime, and request rate. The /api/metrics endpoint returns JSON for integration with Prometheus, Grafana, or custom monitoring stacks.

---

## 🔧 Development

\# Clone the repository

git clone https://github.com/GatewayDev450/mcp-gateway-pro.git

cd mcp-gateway-pro



\# Run locally without Docker

python app.py



\# Build the image locally

docker build -t mcp-gateway-pro:community .



\# Run with Docker Compose

docker-compose up -d

---

## 📝 License

MIT License — see the [LICENSE](LICENSE) file for details.

---

## 🤝 Contributing

Contributions are welcome! Open an issue or submit a pull request on [GitHub](https://github.com/GatewayDev450/mcp-gateway-pro).