⚡ SuperGateway Pro

Daemon centralizado de puerta de enlace MCP, panel de actividad en vivo estilo Vercel y suite para la barra de menús de macOS para agentes de codificación de IA

🌟 Descripción general

SuperGateway Pro es una puerta de enlace Model Context Protocol (MCP) de código abierto y alto rendimiento, un agrupador de conexiones y una consola de observabilidad en tiempo real.

En lugar de que cada cliente de desarrollador de IA (Codex / ChatGPT, Claude Desktop, Antigravity, OpenCode / Codeg) inicie sus propios runtimes aislados de Node.js/Python para exactamente las mismas herramientas (desperdiciando 500 MB – 1.5 GB de RAM y cientos de hilos), SuperGateway Pro mantiene un único grupo de servidores compartidos y precalentados y multiplexa las solicitudes en tiempo submilisegundo.

┌───────────────────────────────────────────────────────────────┐
│     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

✨ Características

• 🏎️ Reducción de huella de memoria de ~83 %: Consolida más de 15 procesos secundarios duplicados de runtime MCP en un único grupo compartido (~85 MB en total frente a ~520 MB duplicados).

• ⚡ Latencia de ejecución inferior a 5 ms: El agrupamiento persistente de conexiones JSON-RPC precalentadas ofrece tiempos de respuesta P50 medios inferiores a 2 ms.

• 🖤 Consola en vivo inspirada en Vercel:

  • Tema oscuro negro puro y tema claro nítido con conmutador instantáneo.

  • Personalizador de fuentes de UI y código monoespaciado (Geist, Inter, Fira Code, JetBrains Mono).

  • Fuente de actividad de herramientas en tiempo real mediante Server-Sent Events (SSE).

  • Sandbox interactivo de ejecución de herramientas para pruebas JSON-RPC instantáneas.

• 🍏 Aplicación nativa para la barra de menús de macOS:

  • Elemento de estado ⚡ MCP 🟢 en la barra de estado de macOS.

  • Contador de ahorro de RAM en vivo.

  • Lanzador del panel con 1 clic y gestión de procesos en segundo plano.

• 🛡️ Copia de seguridad y restauración universales con 1 clic:

  • Crea instantáneas automáticamente de las configuraciones en Codex (~/.codex/config.toml), Claude Desktop (claude_desktop_config.json), Antigravity y OpenCode con manifiestos de integridad SHA-256 y diferencias visuales interactivas.

• 🤖 Compatibilidad con múltiples agentes: Funciona con Codex (ChatGPT), Claude Code / Claude Desktop, Google Antigravity y OpenCode / Codeg de forma inmediata.

📊 Telemetría de referencia

Métricas de referencia reales recopiladas en 20 llamadas a herramientas de solo lectura en serie y 20 en paralelo (5 hilos concurrentes) (ssh-manager, kubernetes-readonly, tabularis):

🚀 Inicio rápido

1. Instalación

# 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. Iniciar el daemon de la puerta de enlace

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

Abre http://localhost:8080/ en tu navegador para acceder al panel de actividad en vivo estilo Vercel.

3. Iniciar la aplicación de la barra de menús de macOS (opcional)

python3 menubar_cocoa.py

🔌 Integración de agentes de IA

A. Codex (ChatGPT)

Añade el proxy a ~/.codex/config.toml:

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

B. Claude Desktop

Añade el proxy a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

📦 Suite universal de copia de seguridad y restauración

# 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

🧪 Ejecución de pruebas de referencia

python3 benchmark_mcp.py

📋 Lista de verificación y hoja de ruta

• Enrutador proxy centralizado JSON-RPC y SSE

• Consola web en tiempo real estilo Vercel con transmisión SSE

• Conmutador de tema claro / oscuro con persistencia

• Personalizador de fuentes de UI y código

• Aplicación nativa de bandeja de la barra de estado de macOS (AppKit / PyObjC)

• Motor universal de copia de seguridad y diferencias de configuración con 1 clic

• Proxies de cliente stdio de Codex y Claude Desktop

• Suite automatizada de pruebas de latencia y rendimiento

• Integración de habilidades de agente (SKILL.md)

📄 Licencia

MIT © Contribuyentes de SuperGateway