Skip to main content
Glama
deenesjakoruzh
odhomane

SuperGateway Pro

by odhomane
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

⚡ SuperGateway Pro

중앙 집중식 MCP 게이트웨이 데몬, Vercel 스타일 실시간 활동 대시보드 및 AI 코딩 에이전트용 macOS 메뉴 바 제품군

License: MIT Node.js Python Platform

🌟 개요

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 런타임 자식 프로세스를 단일 공유 풀로 통합(중복 ~520 MB 대신 총 ~85 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 절감 카운터.

    • 1클릭 대시보드 실행기 및 백그라운드 프로세스 관리.

  • 🛡️ 유니버설 1클릭 백업 및 복원:

    • 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)에서 수집된 실제 벤치마크 지표:

지표

직렬 실행 (20회 호출)

병렬 실행 (5개 스레드)

총 소요 시간

0.369 s

0.240 s

처리량

54.24 calls/sec

83.21 calls/sec

성공률

100.0% (20/20)

100.0% (20/20)

P50 (중앙값) 지연 시간

1.36 ms

3.10 ms

P95 지연 시간

181.28 ms

164.89 ms

절감된 순 메모리

~435 MB (~520 MB에서 ~85 MB로, 83.6% 절감)

🚀 빠른 시작

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)

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

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

  • 자동화된 지연 시간 및 처리량 벤치마크 제품군

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

📄 라이선스

MIT © SuperGateway 기여자들

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers