⚡ SuperGateway Pro

Централизованный MCP-шлюз-демон, живая панель активности в стиле Vercel и набор приложений для строки меню macOS для ИИ-агентов программирования

🌟 Обзор

SuperGateway Pro — это шлюз Model Context Protocol (MCP) с открытым исходным кодом, высокопроизводительный пулер соединений и консоль наблюдения в реальном времени.

Вместо того чтобы каждый ИИ-клиент разработчика (Codex / ChatGPT, Claude Desktop, Antigravity, OpenCode / Codeg) запускал собственную изолированную среду выполнения Node.js/Python для одних и тех же инструментов (тратя 500 МБ – 1,5 ГБ оперативной памяти и сотни потоков), SuperGateway Pro поддерживает единый предварительно разогретый общий пул серверов и мультиплексирует запросы за субмиллисекундное время.

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

✨ Возможности

• 🏎️ Снижение потребления памяти на ~83 %: объединяет 15+ дублирующихся дочерних процессов среды выполнения MCP в единый общий пул (~85 МБ суммарно против ~520 МБ дублирования).

• ⚡ Задержка выполнения менее 5 мс: постоянный предварительно разогретый пул JSON-RPC-соединений обеспечивает медианное время ответа P50 менее 2 мс.

• 🖤 Живая консоль в стиле Vercel:

  • Чистая чёрная тёмная тема и чёткая светлая тема с мгновенным переключателем.

  • Настройка пользовательского интерфейса и моноширинного шрифта для кода (Geist, Inter, Fira Code, JetBrains Mono).

  • Лента активности инструментов в реальном времени через Server-Sent Events (SSE).

  • Интерактивная песочница выполнения инструментов для мгновенного тестирования JSON-RPC.

• 🍏 Нативное приложение для строки меню macOS:

  • Пункт состояния ⚡ MCP 🟢 в строке состояния macOS.

  • Счётчик экономии оперативной памяти в реальном времени.

  • Запуск панели управления в один клик и управление фоновыми процессами.

• 🛡️ Универсальное резервное копирование и восстановление в один клик:

  • Автоматически создаёт снимки конфигураций Codex (~/.codex/config.toml), Claude Desktop (claude_desktop_config.json), Antigravity и OpenCode с манифестами целостности SHA-256 и интерактивной визуальной разницей.

• 🤖 Совместимость с несколькими агентами: из коробки работает с Codex (ChatGPT), Claude Code / Claude Desktop, Google Antigravity и OpenCode / Codeg.

📊 Телеметрия бенчмарков

Реальные показатели бенчмарков, собранные при 20 последовательных и 20 параллельных (5 параллельных потоков) вызовах инструментов только для чтения (ssh-manager, kubernetes-readonly, tabularis):

🚀 Быстрый старт

1. Установка

# 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. Запуск демона шлюза

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

Откройте http://localhost:8080/ в браузере, чтобы получить доступ к живой панели активности в стиле Vercel.

3. Запуск приложения для строки меню macOS (необязательно)

python3 menubar_cocoa.py

🔌 Интеграция с ИИ-агентами

A. Codex (ChatGPT)

Добавьте прокси в ~/.codex/config.toml:

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

B. Claude Desktop

Добавьте прокси в ~/Library/Application Support/Claude/claude_desktop_config.json:

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

📦 Универсальный набор резервного копирования и восстановления

# 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

🧪 Запуск бенчмарков

python3 benchmark_mcp.py

📋 Контрольный список и дорожная карта

• Централизованный прокси-маршрутизатор JSON-RPC и SSE

• Веб-консоль реального времени в стиле Vercel с потоковой передачей SSE

• Переключатель светлой / тёмной темы с сохранением

• Настройка пользовательского интерфейса и шрифта кода

• Нативное приложение для строки состояния macOS (AppKit / PyObjC)

• Универсальное резервное копирование конфигурации и механизм сравнения в один клик

• Прокси-клиенты Codex и Claude Desktop stdio

• Автоматизированный набор тестов задержки и пропускной способности

• Интеграция навыков агента (SKILL.md)

📄 Лицензия

MIT © SuperGateway Contributors