⚡ 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: Shared MCP Gateway

✨ 기능

• 🏎️ 메모리 사용량 ~83% 절감: 15개 이상의 중복 MCP 런타임 자식 프로세스를 단일 공유 풀로 통합(총 ~85 MB 대 중복 ~520 MB).

• ⚡ 5ms 미만 실행 지연 시간: 지속적인 사전 워밍 JSON-RPC 연결 풀링으로 중앙값 P50 응답 시간 2 ms 미만을 달성합니다.

• 🖤 Vercel 스타일 라이브 콘솔:

  • 즉시 전환 가능한 순수 블랙 다크 테마 및 선명한 라이트 테마.

  • 커스텀 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 무결성 매니페스트 및 인터랙티브 시각적 diff와 함께 자동 스냅샷합니다.

• 🤖 멀티 에이전트 호환성: 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 스타일 실시간 웹 콘솔

• 지속성 있는 라이트/다크 테마 전환기

• 커스텀 UI 및 코드 폰트 커스터마이저

• 네이티브 macOS 상태 바 트레이 앱(AppKit / PyObjC)

• 유니버설 원클릭 구성 백업 및 diff 엔진

• Codex 및 Claude Desktop stdio 클라이언트 프록시

• 자동화된 지연 시간 및 처리량 벤치마크 스위트

• 에이전트 스킬(SKILL.md) 통합

📄 라이선스

MIT © SuperGateway Contributors