⚡ SuperGateway Pro

Zentraler MCP-Gateway-Daemon, Live-Aktivitäts-Dashboard im Vercel-Stil und macOS-Menüleisten-Suite für KI-Codierungsagenten

🌟 Übersicht

SuperGateway Pro ist ein Open-Source-Hochleistungs-Model Context Protocol (MCP)-Gateway, Verbindungspooler und Echtzeit-Observability-Konsole.

Anstatt dass jeder KI-Entwickler-Client (Codex / ChatGPT, Claude Desktop, Antigravity, OpenCode / Codeg) seine eigenen isolierten Node.js/Python-Laufzeiten für exakt dieselben Tools startet (wodurch 500MB – 1.5GB RAM und hunderte Threads verschwendet werden), unterhält SuperGateway Pro einen einzelnen, vorgewärmten gemeinsamen Serverpool und multiplext Anfragen in Sub-Millisekunden-Zeit.

┌───────────────────────────────────────────────────────────────┐
│     AI Clients: Codex | Claude Desktop | Antigravity | Codeg  │
└───────────────────────────────┬───────────────────────────────┘
                                │ (Lightweight stdio / SSE)
                                ▼
┌───────────────────────────────────────────────────────────────┐
│       ⚡ SuperGateway Pro Daemon (Port 8080 / <25MB RAM)       │
│  ├─ 📊 Vercel-Style Live Console (SSE Tool Stream)           │
│  ├─ ⚡ macOS Menu Bar Status Item (RAM Footprint Tracker)     │
│  └─ 📦 Universal 1-Click Config Backup & Diff Engine          │
└───────────────────────────────┬───────────────────────────────┘
                                ▼
┌───────────────────────────────────────────────────────────────┐
│   Shared Server Pool: SSH | K8s | Tabularis | Grafana | AWS   │
└───────────────────────────────────────────────────────────────┘

Related MCP server: Shared MCP Gateway

✨ Funktionen

• 🏎️ ~83% Reduzierung des Speicher-Fußabdrucks: Konsolidiert 15+ doppelte MCP-Runtime-Kindprozesse in einem einzigen gemeinsamen Pool (~85 MB gesamt vs. ~520 MB doppelt).

• ⚡ Sub-5ms-Ausführungslatenz: Persistente, vorgewärmte JSON-RPC-Verbindungspooling liefert mediane P50-Antwortzeiten unter 2 ms.

• 🖤 Vercel-inspirierte Live-Konsole:

  • Reines schwarzes dunkles Theme und klares helles Theme mit sofortigem Umschalter.

  • Anpassung von UI und Monospace-Code-Schriftarten (Geist, Inter, Fira Code, JetBrains Mono).

  • Echtzeit-Server-Sent-Events (SSE)-Tool-Aktivitätsfeed.

  • Interaktive Tool-Ausführungs-Sandbox für sofortiges JSON-RPC-Testen.

• 🍏 Native macOS-Menüleisten-App:

  • ⚡ MCP 🟢-Statuselement in der macOS-Statusleiste.

  • Live-RAM-Ersparniszähler.

  • 1-Klick-Dashboard-Starter und Hintergrundprozessverwaltung.

• 🛡️ Universelle 1-Klick-Sicherung und -Wiederherstellung:

  • Erstellt automatisch Snapshots von Konfigurationen über Codex (~/.codex/config.toml), Claude Desktop (claude_desktop_config.json), Antigravity und OpenCode mit SHA-256-Integritätsmanifesten und interaktiven visuellen Diffs.

• 🤖 Multi-Agent-Kompatibilität: Funktioniert sofort mit Codex (ChatGPT), Claude Code / Claude Desktop, Google Antigravity und OpenCode / Codeg.

📊 Benchmark-Telemetrie

Echte Benchmark-Metriken, gesammelt über 20 serielle und 20 parallele (5 gleichzeitige Threads) schreibgeschützte Tool-Aufrufe (ssh-manager, kubernetes-readonly, tabularis):

🚀 Schnellstart

1. Installation

# Clone repository
git clone https://github.com/dhomane/supergateway-pro.git
cd supergateway-pro

# Install Node and Python dependencies
npm install
pip install -r requirements.txt

2. Starten Sie den Gateway-Daemon

# Start SuperGateway server on http://127.0.0.1:8080
node gateway_server.js

Öffnen Sie http://localhost:8080/ in Ihrem Browser, um das Live-Aktivitäts-Dashboard im Vercel-Stil aufzurufen.

3. Starten Sie die macOS-Menüleisten-App (optional)

python3 menubar_cocoa.py

🔌 KI-Agenten-Integration

A. Codex (ChatGPT)

Fügen Sie den Proxy zu ~/.codex/config.toml hinzu:

[mcp_servers.supergateway]
command = "node"
args = ["/path/to/supergateway-pro/unified_mcp_server.js"]
enabled = true

B. Claude Desktop

Fügen Sie den Proxy zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "supergateway": {
      "command": "node",
      "args": ["/path/to/supergateway-pro/unified_mcp_server.js"]
    }
  }
}

📦 Universelle Sicherungs- und Wiederherstellungs-Suite

# Create a timestamped safety backup snapshot
python3 mcp_backup_manager.py backup --tag "my_checkpoint"

# View diff between current active configs and latest backup
python3 mcp_backup_manager.py diff

# List all available backup snapshots
python3 mcp_backup_manager.py list

# Restore from latest (or specific) snapshot
python3 mcp_backup_manager.py restore

🧪 Benchmarks ausführen

python3 benchmark_mcp.py

📋 Checkliste & Roadmap

• Zentraler JSON-RPC- und SSE-Proxy-Router

• Echtzeit-Webkonsole im Vercel-Stil mit SSE-Streaming

• Hell-/Dunkel-Theme-Umschalter mit Persistenz

• Anpassung von UI- und Code-Schriftarten

• Native macOS-Statusleisten-Tray-App (AppKit / PyObjC)

• Universelle 1-Klick-Konfigurationssicherung- und Diff-Engine

• Codex- und Claude-Desktop-Stdio-Client-Proxies

• Automatisierte Latenz- und Durchsatz-Benchmark-Suite

• Agent-Skill-Integration (SKILL.md)

📄 Lizenz

MIT © SuperGateway-Mitwirkende