Skip to main content
Glama
deenesjakoruzh
odhomane

SuperGateway Pro

by odhomane
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

⚡ SuperGateway Pro

面向 AI 编程智能体的集中式 MCP 网关守护进程、Vercel 风格实时活动仪表盘与 macOS 菜单栏应用套件

License: MIT Node.js Python Platform

🌟 概述

SuperGateway Pro 是一款开源、高性能的 模型上下文协议（MCP） 网关、连接池和实时可观测性控制台。

它不会让每个 AI 开发客户端（Codex / ChatGPT、Claude Desktop、Antigravity、OpenCode / Codeg）为同一套工具各自启动孤立的 Node.js/Python 运行时（浪费 500MB–1.5GB 内存和数百个线程），而是维护一个单一、预热的共享服务池，并以亚毫秒级速度复用请求。

┌───────────────────────────────────────────────────────────────┐
│     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 运行时子进程整合到单一共享池中（总计约 85 MB，对比约为 520 MB 的重复占用）。

  • ⚡ 亚 5ms 执行延迟：持久化的、预热的 JSON-RPC 连接池使 P50 中位延迟低于 2 ms。

  • 🖤 Vercel 风格的直播控制台：

    • 纯黑主题与明亮主题，支持一键切换。

    • 自定义 UI 字体和等宽代码字体切换器（Geist、Inter、Fira Code、JetBrains 字体)。

    • 基于服务端发送事件（SSE）的实时工具活动流。

    • 交互式工具箱执行沙盒，用于即时 JSON-RPC 测试。

  • 🍏 原生 macOS 菜单栏应用：

    • macOS 状态栏中的“⚡ MCP 🟢”状态项。

    • 实时内存节省计数器。

    • 一键启动 dashboard 及后台进程管理。

  • 🛡️ 通用一键备份与还原：

    • 自动对 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）中收集的真实基准指标：

指标

串行执行（20 次调用）

并行执行（5 线程）

总耗时

0.369 s

0.240 s

吞吐量

54.24 次调用/秒

83.21 次调用/秒

成功率

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. 启动桌面菜单栏应用（可选）

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 风格的实时 Web 控制台，支持 SSE 流式更新

  • 明暗主题切换，支持持久化

  • 自定义 UI 与代码字体设置

  • 原生 macOS 状态栏托盘应用（AppKit / PyObjC）

  • 通用一键配置备份与 diff 引擎

  • Codex 和 Claude Desktop 的 stdio 客户端代理

  • 自动延迟与吞吐率基准测试套件

  • Agent 技能（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