Skip to main content
Glama

MCP Gateway

一个用于 Model Context Protocol 服务器的自托管控制平面。在一个地方定义你使用的每个 MCP 服务器,通过 Web GUI 管理它们,并为你的代理提供统一端点——既可以按服务器,也可以按整个 组 服务器(工具带命名空间)。

 Claude Code · Claude Desktop · Cursor · VS Code · your agent
        │  Streamable HTTP  /mcp/servers/<id>   /mcp/groups/<id>      (+ API key)
        ▼
 ┌────────────────────── MCP Gateway ──────────────────────┐
 │  web GUI  ·  admin REST API  ·  sessions  ·  logs        │
 │  groups: namespaced tools  pg-analytics__execute_sql …   │
 │  upstream manager: start/stop, restart w/ backoff,       │
 │  health checks, idle stop, tool filters & renames        │
 └───────┬──────────────────┬──────────────────┬───────────┘
   stdio (npx/uvx/docker)   Streamable HTTP     legacy SSE
   Postgres, filesystem…    remote MCP servers  older servers

场景。 一个代理需要两个 Postgres 数据库。你在 GUI 中添加 pg-analytics 和 pg-orders(来自 PostgreSQL (DBHub) 模板),将它们放入名为 databases 的组,并将代理指向 http://gateway:8808/mcp/groups/databases。代理会看到 pg-analytics__execute_sql 和 pg-orders__execute_sql;网关负责管理这些进程、凭据、重启和日志。一个完整且可运行的版本位于 examples/postgres-scenario。

功能

  • 任意上游传输 — stdio 进程(npx、uvx、docker run 等),Streamable HTTP 和带 bearer/basic/header 认证的旧版 SSE 远程服务。

  • 生命周期管理 — 自动/延迟启动、空闲停止、带指数退避和上限的重启、健康检查 ping、启动/请求/工具调用超时、捕获的 stderr。

  • 组 — 多个服务器位于同一端点之后;工具和提示词带命名空间(prefix__tool、. 或 -),或采用带冲突处理的直通;按成员过滤;组合指令;隐式 all 组。

  • 工具策略 — 包含/排除 glob 模式,按服务器隐藏、重命名和重新描述工具。

  • 完整 MCP 代理 — 工具、资源(+模板、订阅)、提示词、补全、日志、进度、取消、list_changed 传播,以及路由回原始会话的服务器→客户端采样 / 引导 / 根。

  • 下游传输 — Streamable HTTP(有状态的可恢复流,或无状态)、旧版 SSE,外加 mcp-gateway-connect,一个面向 Claude Desktop 等客户端的 stdio 桥接。

  • 安全 — API 密钥(哈希存储、限定到服务器/组、可过期)、用于 GUI/API 的管理员令牌、机密信息脱敏、${ENV} 插值让机密永远不必写入配置、DNS 重绑定保护、CORS 允许列表。

  • GUI — 仪表盘、包含 16 个模板的服务器目录(Postgres ×3、MySQL、SQLite、filesystem、GitHub、Playwright、Context7、fetch、memory,……)、带 测试连接 的标签式编辑器、带 试用 的工具浏览器、资源/提示词浏览器、实时日志、指标、按客户端的连接片段、会话、设置、导入/导出(Claude Desktop / Cursor / VS Code 的 mcpServers 文件)。

Related MCP server: Multi-MCP Hub

截图

仪表盘——正在运行的服务器、组、活动会话和实时事件流:

MCP Gateway 仪表盘

服务器目录,一目了然地显示传输方式、状态、工具数量和重启次数:

服务器列表

服务器的详情视图——运行时和端点信息,以及可直接从 GUI 调用工具的工具浏览器:

服务器详情和工具浏览器

快速开始

要求:Node.js ≥ 20(外加运行你所选上游服务器所需的 npx/uvx/docker)。

git clone <this repo> mcp-gateway && cd mcp-gateway
npm install
npm run build
npm start                     # → http://127.0.0.1:8808

然后在 GUI 中:服务器 → 添加服务器 → PostgreSQL (DBHub) → 粘贴 DSN → 测试连接 → 创建服务器。打开服务器的 连接 选项卡,复制适合你客户端的片段,例如:

claude mcp add --transport http pg-analytics http://127.0.0.1:8808/mcp/servers/pg-analytics

开发模式(Vite 在 :5173 上热重载,网关在 :8808 上):npm run dev。

Docker

docker compose up -d --build              # GUI on http://localhost:8808, data in ./data

该镜像内置 node/npx、uvx 和 git,因此基于 npm 和 Python 的 MCP 服务器可以在容器内启动。当端口可被其他主机访问时,在环境中设置 GATEWAY_ADMIN_TOKEN。要预加载配置,请挂载一个文件并设置 GATEWAY_SEED_CONFIG=/path/to/config.json——它会在首次启动时被复制到数据卷。

如何协同工作

概念

说明

服务器

一个上游 MCP 服务器定义:传输、生命周期、工具策略、转发选项。端点为 /mcp/servers/<id>。

组

一组有序的服务器,作为单个虚拟 MCP 服务器对外暴露,工具/提示词带命名空间,资源被合并。端点为 /mcp/groups/<id>。隐式组 all 包含所有已启用的服务器。

API 密钥

用于 /mcp/* 的 Bearer 令牌(静态哈希、限定到服务器/组、可选过期时间)。当 需要 API 密钥 开启时强制执行。

会话

一个已连接的下游客户端(Streamable HTTP 或 SSE)。可在 GUI 中查看和关闭。

管理员令牌

保护 GUI 和 /api/*。通过 GATEWAY_ADMIN_TOKEN 或设置进行设置。

配置是一个单独的 JSON 文件(data/config.json,权限 0600,原子写入,保留 .bak)——每个字段请参阅 docs/CONFIG.md。每个工具对应的客户端设置在 docs/CLIENTS.md;完整设计在 docs/SPEC.md。GUI 还内置了一个 文档 页面(/docs,位于设置旁边),逐步讲解网关的工作原理以及如何添加、自定义和连接服务器。

CLI

mcp-gateway serve [--host 127.0.0.1] [--port 8808] [--data-dir ./data] [--config <file>] [--public-url <url>] [--log-level info]
mcp-gateway import <file> [--format gateway|mcpServers] [--mode merge|replace]    # into the config file (restart to apply)
mcp-gateway export [--format gateway|mcpServers] [--secrets] [--out <file>]
mcp-gateway hash-token <token>                                                     # sha256 for settings.auth.adminTokenHash
mcp-gateway connect <url> [--api-key K] [--header 'Name: v'] [--sse]              # stdio ⇄ HTTP bridge
mcp-gateway-connect <url> …                                                        # same bridge as a standalone package (@mcp-gateway/connect)

环境变量:GATEWAY_HOST、GATEWAY_PORT、GATEWAY_DATA_DIR、GATEWAY_CONFIG、GATEWAY_ADMIN_TOKEN、GATEWAY_PUBLIC_URL、GATEWAY_LOG_LEVEL、GATEWAY_REQUIRE_API_KEY、GATEWAY_WEB_DIR、GATEWAY_SEED_CONFIG(Docker)。优先级:CLI 标志 > 环境变量 > config.json > 默认值。

端点

路径

用途

POST/GET/DELETE /mcp/servers/:id · /mcp/groups/:id

Streamable HTTP MCP 端点

GET /mcp/servers/:id/sse + POST …/messages?sessionId=(组同理)

旧版 HTTP+SSE

GET /api/health

存活检查(无需认证)

/api/servers, /api/groups, /api/keys, /api/sessions, /api/logs, /api/settings, /api/templates, /api/config/{export,import}, /api/connect/:kind

管理员 REST API(JSON;设置后使用 Authorization: Bearer <admin token>)

GET /api/events

由 GUI 使用的服务器推送事件流(状态、日志、会话、指标)

/

Web GUI

完整的路由列表及请求/响应格式见 docs/SPEC.md §7。

安全说明

  • 如果没有管理员令牌,GUI/API 将处于开放状态:请保持默认的回环绑定,或设置 GATEWAY_ADMIN_TOKEN。

  • 在将 /mcp 暴露到 localhost 之外前,请开启 需要 API 密钥;将密钥限定到每个代理所需的服务器/组。

  • 机密信息:优先使用 ${VAR} 引用而非字面值;在 API 响应和导出中,看起来像密钥的键下的值会被脱敏(?secrets=1 / 包含机密 导出会包含它们)。

  • 对任何面向互联网的服务,在前面放置一个 TLS 终止反向代理(Anthropic API MCP 连接器需要)。

  • 网关会执行你配置的命令——任何拥有管理员权限的人都可在主机上运行任意进程。

开发

npm run dev          # gateway (tsx watch) + Vite dev server
npm run typecheck    # all workspaces
npm test             # vitest: shared unit tests, server integration tests (real stdio/HTTP fixtures), bridge tests
npm run build        # server bundle (esbuild), connect bundle, web (vite)

目录结构:packages/shared(zod 配置模式、DTO、模板、命名辅助工具——浏览器安全)、packages/server(Express 5 + @modelcontextprotocol/sdk:上游管理器、代理服务器、会话、REST/MCP 路由、CLI)、packages/web(React 19 + Vite)、packages/connect(stdio 桥接)、examples/postgres-scenario(docker-compose 演示)。

限制 / 路线图

  • 尚未实现对上游服务器的 OAuth(请使用 bearer/basic/header 认证);OAuth 用于下游客户端也未实现(改用 API 密钥)。

  • 组中的资源不带命名空间——URI 会路由到其所属服务器;多个成员间相同的 URI 将解析到第一个成员。

  • 没有速率限制;如果需要,请在前面放一个反向代理。

  • 单进程、内存中的会话和日志(重启会丢弃会话;客户端需重新初始化)。

许可证

Apache License 2.0——请参阅 LICENSE 和 NOTICE。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Aggregates multiple MCP servers behind a single, secure endpoint with unified tool/resource discovery, OAuth authentication, and resilient request routing. Enables users to manage and interact with multiple MCP backends through one centralized interface with load balancing and circuit breakers.
      2
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A centralized gateway and router that integrates multiple MCP servers into a single endpoint with built-in policy enforcement and secret management. It features a Web GUI for managing tool access, audit logs, and multi-environment configurations across various sub-servers.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Aggregates multiple MCP servers into a single HTTP endpoint with tool namespacing, dashboard, and REST API for management.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Aggregates multiple MCP servers into a single unified endpoint with hot-plugging, multi-protocol support, and management via web and CLI.
      MIT