⚡ SuperGateway Pro

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

🌟 概要

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

すべてのAI開発クライアント（Codex / ChatGPT、Claude Desktop、Antigravity、OpenCode / Codeg）が、まったく同じツールのために独自の分離されたNode.js/Pythonランタイム（RAM 500MB〜1.5GB と数百ものスレッドを浪費）を起動する代わりに、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 MB に対して重複 ~520 MB）。

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

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

  • 純黒のダークテーマ＆鮮明なライトテーマ、インスタント切り替え対応。

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

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

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

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

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

  • ライブのRAM削減カウンター。

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

• 🛡️ ユニバーサルなワンクリックバックアップ＆リストア:

  • 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）

• ユニバーサルなワンクリック構成バックアップ＆差分エンジン

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

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

• エージェントスキル（SKILL.md）統合

📄 ライセンス

MIT © SuperGateway Contributors