⚡ SuperGateway Pro

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

🌟 Обзор

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

Вместо того чтобы каждый AI-клиент разработчика (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: Shared MCP Gateway

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

• 🏎️ Сокращение потребления памяти на ~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

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

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)

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

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

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

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

📄 Лицензия

MIT © SuperGateway Contributors