⚡ SuperGateway Pro

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

🌟 Überblick

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

Anstatt dass jeder KI-Entwickler-Client (Codex / ChatGPT, Claude Desktop, Antigravity, OpenCode / Codeg) seine eigene isolierte Node.js/Python-Laufzeitumgebung für genau dieselben Tools startet (was 500 MB – 1,5 GB RAM und hunderte Threads verschwendet), unterhält SuperGateway Pro einen einzelnen, vorgewärmten gemeinsamen Serverpool und multiplexiert 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: macOS Companion MCP Server

✨ Funktionen

• 🏎️ ~83 % Speicherverbrauchsreduzierung: Konsolidiert 15+ doppelte MCP-Laufzeit-Subprozesse in einen 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 Schwarz-Dunkelthema und klares Hellthema mit sofortigem Umschalter.

  • Benutzerdefinierter UI- und Monospace-Code-Schriftarten-Anpasser (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-Ersparnis-Zähler.

  • 1-Klick-Dashboard-Starter und Hintergrundprozessverwaltung.

• 🛡️ Universelle 1-Klick-Backup- 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-Messwerte, 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. Gateway-Daemon starten

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

Öffnen Sie http://localhost:8080/ in Ihrem Browser, um auf das Vercel-ähnliche Live-Aktivitäts-Dashboard zuzugreifen.

3. macOS-Menüleisten-App starten (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 Backup- 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

• Vercel-ähnliche Echtzeit-Web-Konsole mit SSE-Streaming

• Hell-/Dunkel-Theme-Umschalter mit Persistenz

• Benutzerdefinierter UI- und Code-Schriftarten-Anpasser

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

• Universelle 1-Klick-Konfigurations-Backup- und Diff-Engine

• Codex- und Claude-Desktop-Client-Proxys

• Automatisierte Latenz- und Durchsatz-Benchmark-Suite

• Agent-Skill (SKILL.md)-Integration

📄 Lizenz

MIT © SuperGateway-Mitwirkende