# 🔌 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.

```bash
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

```yaml
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

```bash
# 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).

---

**Built with ❤️ using Python, Wolfi, and Docker.**