Skip to main content
Glama

MCP Gateway


πŸ“– Overview

MCP Gateway is a native, cross-platform desktop control plane and multiplexer for Anthropic's Model Context Protocol (MCP).

Normally, AI agents and IDEs (Cursor, Claude Desktop, Antigravity, Windsurf, Zed, Cline) require managing dozens of fragmented, individual MCP server processes. This results in port conflicts, memory bloat, high latencies, zero centralized access control, and complete lack of traffic observability.

MCP Gateway solves this by acting as a high-performance unified reverse proxy:

  • Exposes a single multiplexed SSE/HTTP endpoint (http://127.0.0.1:8080/sse) to your AI clients.

  • Connects simultaneously to multiple downstream MCP servers over Stdio, Server-Sent Events (SSE), and Streamable HTTP.

  • Dynamically aggregates, namespaces, audits, and secures all tools, prompts, resources, and service extensions.

flowchart LR
    subgraph AI_Clients["AI IDEs & Agents"]
        C1["Claude Desktop"]
        C2["Cursor"]
        C3["Antigravity / Gemini"]
        C4["Windsurf / Zed"]
    end

    subgraph Gateway["MCP Gateway (Tauri v2 + Rust Core)"]
        direction TB
        Proxy["Unified SSE / HTTP Hub (:8080)"]
        SecGuard["Security Guardrails & Token Auth"]
        ApprModal["Interactive Tool Approval Modal"]
        Router["Tool Namespacing & Router"]
        DBEng["Built-in DB Engine (PG/SQLite/MySQL/Redis)"]
        TelMon["Live Telemetry & RPC Logger"]
        Tunnel["Cloudflare Zero Trust Tunnel"]
    end

    subgraph Upstream["Upstream MCP Servers"]
        S1["Local Stdio Servers (Docker, Node, Python)"]
        S2["Remote SSE Servers (Coolify, EasyPanel)"]
        S3["Cloud MCP Services"]
        S4["Databases & Storage (via Hub)"]
    end

    AI_Clients -->|Single SSE Connection| Proxy
    Proxy --> SecGuard
    SecGuard --> ApprModal
    ApprModal --> Router
    Router --> S1
    Router --> S2
    Router --> S3
    Router --> DBEng
    DBEng --> S4
    Tunnel -.->|Secure Remote Ingress| Proxy
    TelMon -.->|Observe| Router

Related MCP server: mcp_proxy

✨ Features & Capabilities

1. ⚑ Unified Multi-Transport Multiplexing

  • Single Endpoint for AI: Point Claude Desktop or Cursor to http://127.0.0.1:8080/sse and gain instant access to every configured server.

  • Multi-Transport Support:

    • Stdio: Local binaries, Node (npx), Python (uvx), Docker containers.

    • SSE (Server-Sent Events): Long-lived real-time streams.

    • Streamable HTTP: Remote cloud MCP endpoints with custom auth headers.

  • Smart Tool Namespacing: Prevents name collisions across servers by auto-namespacing tools (e.g., coolify__<tool>, github__<tool>).

2. πŸ›‘οΈ Enterprise-Grade Security & Guardrails

  • Bearer Token Management: Generate, inspect, rotate, and revoke cryptographically secure API tokens with customizable expiry and permission scopes.

  • Granular Permission Policies: Set per-server and per-tool rules:

    • Allow: Auto-execute without friction.

    • Require Approval: Pops up an interactive approval dialog before execution.

    • Deny: Blocks access entirely.

  • Interactive Approval Modal: Review tool arguments, target server, and operation severity before confirming destructive actions (e.g., DROP TABLE, container teardowns).

  • Zero-Secrets Policy: Tokens and credentials stay strictly local on host memory/storage; never exposed in telemetry or client error responses.

3. 🌐 Cloudflare Tunnel (Remote Zero-Trust Access)

  • Direct Remote Sharing: Share your local MCP servers with remote team members or cloud AI agents without public IP or firewall port forwarding.

  • Integrated Control: Start, stop, and inspect the tunnel status and public ingress hostname directly from the desktop UI.

4. πŸ“¦ Registry & MCP Package Hub (1-Click Database & Service Extensions)

  • Curated MCP Package Directory: Effortlessly discover, install, and run official and community MCP servers in 1-click.

  • Full Database Ecosystem: Connect PostgreSQL (@modelcontextprotocol/server-postgres), SQLite (mcp-server-sqlite), and Redis (mcp-server-redis) via standard MCP specifications without bloating the gateway core.

  • Extensible Integration: Install DevOps, developer tools, web search (Brave, Puppeteer, Docker), and memory servers with automatic parameter prompts and verification.

5. πŸ§ͺ Interactive Tools Explorer & Playground

  • JSON Schema Inspector: Auto-parses tool parameter definitions (inputSchema) into clean visual forms.

  • Live Test Runner: Trigger any MCP tool directly inside the GUI, view execution latency, and inspect formatted JSON results.

  • Search & Filter: Real-time filtering, category sorting, and pagination across dozens or hundreds of aggregated tools.

6. πŸ“œ Resources & Prompts Explorer

  • MCP Resources: Browse file URIs, database schemas, and persistent application state exposed by connected servers.

  • Prompt Templates: Inspect registered prompt templates, variable slots, and sample prompts.

7. πŸ“Š Real-Time Traffic & RPC Telemetry

  • Live JSON-RPC Stream: Inspect bi-directional messages (tools/call, tools/list, resources/read, ping).

  • Telemetry Metrics: Real-time roundtrip latency (ms), success/error rates, and daily call counts.

  • Audit Log Controls: Search logs, auto-scroll toggle, pause/resume streaming, and 1-click JSON log export.

8. πŸ”„ IDE Auto-Discovery & 1-Click Sync

  • Automatic Config Scans: Scans and detects installed MCP configurations from:

    • ~/.cursor/mcp.json (Cursor)

    • ~/.gemini/config/mcp_config.json (Antigravity)

    • ~/Library/Application Support/Claude/claude_desktop_config.json (Claude Desktop)

    • Windsurf configuration directories

  • Export mcp.json: Generate a clean, 1-click configuration snippet ready to paste into any client.

9. 🎨 Modern Native Desktop Experience

  • Responsive Layout: Fluid design built with Tailwind CSS v4, collapsible icon sidebar rail with tooltips, and screen-size adaptive buttons.

  • Table Pagination & Sorting: Robust pagination and column sorting across all data grids.

  • Native macOS & Windows Assets: Transparent floating quantum gateway emblem (.icns for macOS Dock, .ico for Windows).

10. πŸ”” System Tray & Background Daemon Mode

  • Zero-Disruption Background Core: Closing the window automatically minimizes MCP Gateway to the macOS Menu Bar / Windows System Tray, ensuring AI IDEs (Cursor, Claude) maintain active connections without interruption.

  • Quick Actions Menu: Open dashboard, inspect Core status, copy the active SSE endpoint, or quit directly from the system tray.

11. πŸ›‘οΈ Data Loss Prevention (DLP) & Secret Redactor

  • Automated Response Sanitization: Scans all outgoing tool results and database outputs before returning to AI context windows.

  • Comprehensive Threat Patterns: Redacts or blocks OpenAI keys, Anthropic tokens, GitHub PATs, AWS credentials, Google Gemini keys, Slack tokens, JWTs, PEM private keys, DB connection passwords, credit cards (PCI-DSS), and PII email addresses.

  • Configurable Enforcement: Supports Mask (redact inline), Block (halt tool call), and Audit policies, complete with an interactive live DLP testing simulator.

12. πŸ›’ MCP Hub & Package Registry (1-Click Connect)

  • Curated Server Catalog: Built-in App Store featuring verified MCP servers (GitHub, Brave Search, Filesystem, PostgreSQL, SQLite, Docker, Fetch, Memory, Slack, Puppeteer, GitLab, Redis).

  • 1-Click Installation: Interactive setup dialog automatically handles runtime commands (npx, uvx) and required environment credentials.

13. 🐳 Headless Daemon & Docker Server Deployment

  • Headless CLI Binary: Run MCP Gateway as a standalone server without a GUI via mcp-gateway --headless --port 8080 or mcp-gateway-cli --host 0.0.0.0 --port 8080.

  • Docker Ready: Includes production Dockerfile and docker-compose.yml for VPS and cloud deployments.


πŸš€ Getting Started

Prerequisites

  • Node.js (v20+) or Bun (recommended)

  • Rust (latest stable) & Cargo (for Tauri v2 native desktop core)

Installation

  1. Clone the repository:

    git clone https://github.com/neondeveloperz/mcp-gateway.git
    cd mcp-gateway
  2. Install frontend dependencies:

    bun install
    # or: npm install
  3. Run in development mode (Desktop App):

    bun run tauri dev
  4. Build native production binaries:

    # Build desktop GUI installer (.dmg / .exe / .AppImage / .deb)
    bun run build:gui
    
    # Build standalone headless CLI binary (mcp-gateway-cli)
    bun run build:cli
    
    # Build both GUI and CLI binaries
    bun run build:all

    The compiled desktop installer (.dmg on macOS, .msi / .exe on Windows) will be located in src-tauri/target/release/bundle/, and the standalone CLI executable in src-tauri/target/release/mcp-gateway-cli.


πŸ”Œ Connecting to AI Clients

Add MCP Gateway to your AI client's configuration file as a single multiplexed server:

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "curl",
      "args": ["-s", "-N", "http://127.0.0.1:8080/sse"],
      "headers": {
        "Authorization": "Bearer YOUR_GATEWAY_TOKEN"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "mcp-gateway": {
      "url": "http://127.0.0.1:8080/sse",
      "headers": {
        "Authorization": "Bearer YOUR_GATEWAY_TOKEN"
      }
    }
  }
}

Antigravity / Gemini CLI (~/.gemini/config/mcp_config.json)

{
  "mcpServers": {
    "mcp-gateway": {
      "url": "http://127.0.0.1:8080/sse",
      "headers": {
        "Authorization": "Bearer YOUR_GATEWAY_TOKEN"
      }
    }
  }
}

πŸ› οΈ Project Architecture

mcp-gateway/
β”œβ”€β”€ public/                 # Static assets, web favicon, app-icon
β”œβ”€β”€ src-tauri/              # Rust Native Backend (Tauri v2 Core)
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ bin/
β”‚   β”‚   β”‚   └── cli.rs      # Headless CLI entrypoint
β”‚   β”‚   β”œβ”€β”€ lib.rs          # Tauri command dispatcher & lifecycle
β”‚   β”‚   β”œβ”€β”€ gateway.rs      # Unified MCP routing engine & SSE server
β”‚   β”‚   β”œβ”€β”€ discovery.rs    # Host telemetry & IDE config scanner
β”‚   β”‚   β”œβ”€β”€ dlp.rs          # Data Loss Prevention regex engine & incident manager
β”‚   β”‚   β”œβ”€β”€ security.rs     # Token guardrails & permission checks
β”‚   β”‚   β”œβ”€β”€ tunnel.rs       # Cloudflare Tunnel integration
β”‚   β”‚   └── types.rs        # Shared Rust types & data structures
β”‚   β”œβ”€β”€ icons/              # Multi-resolution native app icons (.icns, .ico)
β”‚   └── Cargo.toml          # Rust dependencies & optimization profiles
β”œβ”€β”€ src/                    # Frontend GUI (React 19 + TypeScript)
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ overview/       # Gateway dashboard, activity charts & stats
β”‚   β”‚   β”œβ”€β”€ servers/        # Server manager, connection state & actions
β”‚   β”‚   β”œβ”€β”€ marketplace/    # Registry & MCP Package Hub
β”‚   β”‚   β”œβ”€β”€ tools/          # Interactive tool tester & parameter form
β”‚   β”‚   β”œβ”€β”€ resources/      # Prompt templates & resource inspector
β”‚   β”‚   β”œβ”€β”€ logs/           # Real-time JSON-RPC traffic monitor
β”‚   β”‚   β”œβ”€β”€ tunnel/         # Cloudflare Tunnel controller
β”‚   β”‚   β”œβ”€β”€ tokens/         # Bearer token generator & permissions
β”‚   β”‚   β”œβ”€β”€ security/       # Guardrail rules & interactive approval modal
β”‚   β”‚   β”œβ”€β”€ status/         # System telemetry & ping health probes
β”‚   β”‚   └── ui/             # shadcn/ui components, pagination, sorting
β”‚   β”œβ”€β”€ lib/
β”‚   β”‚   └── mcp-service.ts  # Gateway API client & event dispatcher
β”‚   β”œβ”€β”€ App.tsx             # Main view router & layout container
β”‚   └── main.tsx            # Application entry point
β”œβ”€β”€ package.json
└── README.md

πŸ›‘οΈ Security & Privacy

  • Local-First Architecture: MCP Gateway runs strictly on your local machine (127.0.0.1). No telemetry or code is sent to external cloud servers unless you explicitly configure a Cloudflare Tunnel.

  • Fail-Safe Approvals: Destructive actions can be gated behind human confirmation via the approval modal.

  • Encrypted Local Storage: Stored tokens and server credentials follow least-privilege host permissions.


πŸ“„ License

This project is licensed under the MIT License.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Centralizes management and routing of multiple MCP servers, exposing them to AI clients via HTTP/SSE endpoints with configurable visibility, sharing, and smart routing.
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables centralized routing, discovery, namespacing, and execution of tools from multiple remote MCP servers over HTTP/SSE, aggregating them behind a unified MCP gateway with dynamic server management.
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables clients to connect to, manage, and aggregate multiple backend MCP servers and access their combined tools and resources through unified SSE or Streamable HTTP endpoints, or as a single Stdio server. It provides request routing, optional authentication, granular tool controls, and an optional web admin interface.
      120 npm
      MIT