⚡ SuperGateway Pro

AIコーディングエージェント向けの集中型MCPゲートウェイデーモン、Vercelスタイルのライブアクティビティダッシュボード、macOSメニューバースイート

🌟 概要

SuperGateway Pro は、オープンソースで高性能な Model Context Protocol (MCP) ゲートウェイ、コネクションプーラー、リアルタイム可観測性コンソールです。

従来のAI開発クライアント（Codex / ChatGPT、Claude Desktop、Antigravity、OpenCode / Codeg）は、まったく同じツールのために個別のNode.js/Pythonランタイムを起動し、500MB～1.5GBのRAMと数百のスレッドを消費していました。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ランタイム子プロセスを単一の共有プールへ統合（重複時は約520MBから約85MBへ）。

• ⚡ 5ms未満の実行レイテンシ: 永続化されたプリウォーム済みJSON-RPCコネクションプーリングにより、中央値P50応答時間は 2ms未満。

• 🖤 Vercel風のライブコンソール:

  • 純黒のダークにテーマとクリアなライトテーマを瞬時に切り替え可能。

  • UIと等幅コードフォントのカスタマイズ（Geist、Inter、Fira Code、JetBrains Mono）。

  • リアルタイムのServer-Sent Events（SSE）ツールアクティビティフィード。

  • JSON-RPCをすぐにテストできるインタラクティブなツール実行サンドボックス。

• 🍏 ネイティブmacOSメニューバーアプリ:

  • macOSステータスバーに ⚡ MCP 🟢 ステータスアイテムを表示。

  • メモリ削減量をライブで表示するカウンタ。

  • ワンクリックのダッシュボード起動とバックグラウンドプロセス管理。

• 🛡️ ユニバーサルな1クリックバックアップ&リストア:

  • 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プロキシルーター

• SSEストリーミング対応のVercelスタイルリアルタイムWebコンソール

• ライト／ダークテーマ切替（永続化付き）

• UIとコードフォントのカスタマイザー

• ネイティブ macOS ステータスバートレイアプリ（AppKit / PyObjC）

• ユニバーサルなワンクリック設定とdiffエンジン

• Codex と Claude Desktop の stdio クライアントプロキシ

• 自動レイテンシ＆スループットのベンチマークスイート

• コンテナスキル（SKILL.md）の統合

📄 ライセンス

MIT © SuperGateway Contributors