← 返回目录
S

Supergateway

社区
一条命令,让 MCP stdio 服务器通过 SSE 或 WebSocket 运行。
GitHub 源仓库 ↗
★ 2.8k Stars 分类 · 开发工具 热门 源版本 973c4595250d
63FMRS · C
可靠性
10/20
安全与权限
10/20
维护活跃度
14/20
文档质量
15/20
安装易用性
14/20

Supergateway 是一个实用的 MCP 传输桥接工具,能够灵活转换多种传输协议,并支持 Docker 部署和主流客户端集成。它适合需要远程访问 MCP 服务器的开发者,但需要注意安全配置。

查看 FMRS 评分方法 →

Supergateway 是一个 AI 网关工具,用于将仅支持 stdio 的 MCP 服务器转换为 SSE、WebSocket 或 Streamable HTTP 传输协议,或者反向转换。它允许远程访问、调试和集成那些原本只能通过标准输入输出工作的 MCP 服务器。

工具能力

暂未整理工具清单。

安装接入

使用 npx 运行,无需单独安装。例如:npx -y supergateway --stdio "uvx mcp-server-git"

选型与风险

适合谁

  • 需要将 stdio MCP 服务器暴露给 Web 或远程客户端的开发者。
  • 希望将远程 MCP 服务器集成到本地 CLI 工具或桌面应用(如 Claude Desktop、Cursor)的用户。
  • 希望通过 Docker 快速部署 MCP 代理的用户。

不适合谁

  • 需要 MCP 服务器管理功能(如监控、审计)的用户。
  • 希望零配置即可运行的用户,需要理解并设置传输参数。

所需权限

  • 执行任意命令(通过 --stdio 参数)。
  • 网络访问:可监听端口(--port)和连接远程 URL。
  • 可读取和写入文件系统(依赖于所代理的 MCP 服务器)。

风险与副作用

  • 使用 --stdio 运行任意命令可能带来安全风险,如果命令来源不可信。
  • 暴露 MCP 服务器到网络时,如果没有认证措施(如 --header 或 --oauth2Bearer),可能被未授权访问。
  • 配置文件中的敏感信息(如令牌)可能被泄露。

常见排障

  1. 确保端口未被占用,且防火墙允许访问。
  2. 检查 --stdio 命令是否正确,以及 MCP 服务器是否能正常启动。
  3. 对于远程连接,检查 URL 和认证头是否正确。
  4. 使用 --logLevel debug 获取详细日志以排查问题。

使用场景

将本地 stdio MCP 服务器暴露为 SSE 或 WebSocket 服务,以便远程访问。
将远程 SSE 或 Streamable HTTP MCP 服务器转换为本地 stdio,以便在命令行环境中使用。
通过 ngrok 或 Docker 部署,实现公共访问。

支持客户端

Claude Desktop完整支持
Cursor完整支持