Which integrations are available for this server?

Used to provision registry MCP servers on demand in isolated Docker containers, though this is an implementation detail of the gateway itself. Provides access to the official GitHub MCP server, enabling repository and development workflow management (requires gh auth). Provisioned MCP servers have blocked Tailscale egress, and multi-device support can manage remote devices over Tailscale-enabled networks.

How do I use Universal MCP Gateway?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Universal MCP Gateway Set up a Postgres MCP server from the registry to inspect my database schema" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Universal MCP Gateway

by Samuel-Mencke

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

Universal MCP Gateway

A self-hosted Model Context Protocol (MCP) gateway that aggregates all your MCP servers behind a single Streamable HTTP endpoint. Includes automatic registry discovery, on-demand Docker provisioning, and multi-device support.

Features

Single Endpoint — All MCP servers exposed via one URL (/all for universal, /mcp for legacy)
Registry Auto-Broker — Mirrors the official MCP Registry (19,000+ servers), provisions on demand in isolated Docker containers
Multi-Device — Control server, laptop, and Windows PC from one gateway via SSH
SSE Keepalive — Prevents Cloudflare/proxy idle timeouts on streaming connections
OAuth2 PKCE — Optional OAuth2 authorization code flow with PKCE support
Workflow Engine — Save and replay multi-step tool sequences
Bearer Auth — Simple token-based authentication

Related MCP server: MCPHubs

Architecture

                    mcp.yourdomain.com (:8798)
                           │
                    ┌──────▼──────┐
                    │ MCP Router  │  Path-based routing
                    │  router.mjs │  /all → Universal, /mcp → Legacy
                    └──────┬──────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
    ┌─────────▼──┐  ┌─────▼────┐  ┌──▼──────────┐
    │ Universal  │  │ Registry │  │  Child MCPs │
    │ Gateway    │  │ Autobroker│  │ (remote +   │
    │ gateway.mjs│  │ registry- │  │  stdio)     │
    └────────────┘  │ manager   │  └─────────────┘
                    └───────────┘

Quick Start

# Clone
git clone https://github.com/Samuel-Mencke/mcp-gateway.git
cd mcp-gateway

# Install dependencies
npm install

# Configure
cp .env.example .env
# Edit .env — set MCP_PUBLIC_URL and generate a token

# Generate auth token
echo -n "$(openssl rand -hex 32)" > ~/.mcp-gateway/token

# Start the gateway
node gateway.mjs    # Port 8799
# In another terminal:
node router.mjs     # Port 8798 (public-facing)

Configuration

All configuration is via environment variables. See .env.example for all options.

Key Variables

Variable	Default	Description
`MCP_PORT`	`8799`	Universal Gateway listen port
`MCP_ROUTER_PORT`	`8798`	Router listen port
`MCP_PUBLIC_URL`	`http://localhost:8798`	Your public URL (domain/tunnel)
`MCP_STATE_DIR`	`~/.mcp-gateway`	State directory (registry, tokens, etc.)
`MCP_BEARER_TOKEN`	(from `$MCP_STATE_DIR/token`)	Auth token

Multi-Device (Optional)

Set these to enable SSH-based remote control:

# Windows PC
MCP_PC_HOST=windows-host
MCP_PC_USER=username

# Linux laptop
MCP_LAPTOP_HOST=laptop-host
MCP_LAPTOP_USER=username

Default MCP Servers

The gateway ships with these servers enabled by default:

Context7 — Current library documentation
Exa — Web search and fetch
MCP Docs — Official MCP documentation
GitHub — Official GitHub MCP server (requires gh auth)
Playwright — Browser automation
Chrome DevTools — Debugging and performance
Filesystem — Sandboxed file access
Memory — Persistent knowledge graph
Sequential Thinking — Structured planning

Additional servers can be provisioned on demand from the official MCP Registry via ensure_capability.

Registry Auto-Broker

The gateway mirrors the complete official MCP Registry and can provision any supported server on demand:

Agent: "I need PostgreSQL schema inspection"
Gateway: Searches registry → provisions postgres-mcp → probes handshake → ready

Provisioned servers run in restricted Docker containers:

Read-only root filesystem
No host mounts
Dropped capabilities
CPU/RAM/PID limits
Blocked private/Tailscale egress

Deployment

systemd

# ~/.config/systemd/user/mcp-router.service
[Unit]
Description=MCP Router
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/mcp-gateway
Environment=MCP_ROUTER_PORT=8798
ExecStart=/usr/bin/node %h/mcp-gateway/router.mjs
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

# ~/.config/systemd/user/mcp-universal.service
[Unit]
Description=MCP Universal Gateway
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/mcp-gateway
EnvironmentFile=%h/mcp-gateway/.env
ExecStart=/usr/bin/node %h/mcp-gateway/gateway.mjs
Restart=always
RestartSec=5
TimeoutStopSec=20

[Install]
WantedBy=default.target

Cloudflare Tunnel

No port-forwarding needed — use a Cloudflare Tunnel:

# ~/.cloudflared/config.yml
ingress:
  - hostname: mcp.yourdomain.com
    service: http://127.0.0.1:8798
    originRequest:
      noTLSVerify: true
      connectTimeout: 30s
      keepAliveConnections: 100
      keepAliveTimeout: 600s

Client Configuration

The gateway works with any MCP-compatible client:

Client	Config
Claude Code	`type: "url", url: "https://mcp.yourdomain.com/all"`
OpenAI Codex	`type: "streamable-http", url: "https://mcp.yourdomain.com/all"`
Cursor	`url: "https://mcp.yourdomain.com/all", transport: "streamable-http"`
Hermes Agent	`type: "streamable-http", url: "https://mcp.yourdomain.com/all"`
OpenCode	`type: "streamable-http", url: "https://mcp.yourdomain.com/all"`

All clients need: headers: { Authorization: "Bearer <your-token>" }

Files

File	Description
`router.mjs`	Path-based router, OAuth2, SSE keepalive
`gateway.mjs`	Universal MCP gateway server
`registry-manager.mjs`	Registry sync, auto-provisioning, AGENTS.md generation
`workflow-store.mjs`	Durable workflow persistence
`server.mjs`	Legacy ChatGPT connector (admin/SSH tools)
`windows-runner.py`	Windows desktop automation runner

Requirements

Node.js >= 18
Docker (for registry auto-provisioning)
SSH access (for multi-device support)

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

OneDroid SynapseOAuth
ai.onedroid
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Security Observability
1
MCP Aggregation Gateway — 22k+ MCP search & call A
cn.pianam.mcp
One AI endpoint to search and call 22k+ MCP servers; 50+ hosted tools work instantly, no key.
Agent Orchestration Search
31
cortex-gatewayOAuth
io.github.wellknownmcp
Self-hosted federated MCP gateway: one OAuth 2.1 MCP server in front of N apps, user-level scopes.
Security Developer Tools
212
nexusOAuth
com.civic
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Agent Orchestration Developer Tools App Automation
2

Related MCP Servers

mcpproxy-go
Developer Tools Agent Orchestration Security
smart-mcp-proxy
A
license
A
quality
A
maintenance
Local-first MCP proxy with BM25 tool discovery, quarantine security, Docker isolation, OAuth support, activity logging, and web UI. Routes multiple upstream MCP servers through a single endpoint.
Updated 20 hours ago (2026-09-15 08:10 UTC)
9
350
MIT
MCPHubs
Developer Tools Agent Orchestration
7-e1even
A
license
Not graded
quality
C
maintenance
A unified gateway and web dashboard that aggregates multiple MCP servers into a single Streamable HTTP endpoint. It supports stdio, SSE, and HTTP protocols, featuring optimized tool exposure modes to reduce token consumption for AI clients.
Updated 6 months ago (2026-03-23 02:05 UTC)
5
MIT
MCPGate
Developer Tools Observability
martin-santiago
A
license
Not graded
quality
D
maintenance
MCPGate aggregates multiple MCP servers into a single unified endpoint, enabling centralized tool management with granular filtering, automatic namespacing, and observability. Features a real-time web dashboard and optional PostgreSQL-backed audit trails for monitoring and controlling AI tool access across local and remote deployments.
Updated 4 months ago (2026-05-06 16:24 UTC)
6 npm
Apache 2.0
MCP Manager
Developer Tools Agent Orchestration
daniel3303
A
license
Not graded
quality
B
maintenance
Self-hosted MCP proxy and aggregation platform. Register multiple upstream MCP servers and expose them through a single unified endpoint with namespace routing, multi-transport support (HTTP/SSE, stdio, OpenAPI→MCP), per-tool overrides, and a web admin UI.
Updated a month ago (2026-08-13 16:46 UTC)
17
MIT

Universal MCP Gateway

Features

Architecture

Quick Start

Configuration

Key Variables

Multi-Device (Optional)

Default MCP Servers

Registry Auto-Broker

Deployment

systemd

Cloudflare Tunnel

Client Configuration

Files

Requirements

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcpproxy-go

MCPHubs

MCPGate

MCP Manager