← 返回目录

Supergateway

社区

网关 / 代理

一条命令，让 MCP stdio 服务器通过 SSE 或 WebSocket 运行。

这是聚合或代理其他 MCP Server 的网关，需要再接入具体的 Server 才有实际能力。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 74 / 438
Stars: ★ 2.9k 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js 24+ · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 2 天前

63FMRS · C

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

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

10/20

维护活跃度

14/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 仓库包含类型定义、构建脚本和测试（Node Test Runner），且有 GitHub Actions 工作流，但未审查测试内容是否覆盖关键路径。由于是静态审查，未能执行验证，因此限制评分不超过12。关键功能（stdio↔SSE/WS/streamable HTTP）在 README 中有详细说明，但错误处理和边缘案例在源码中未见明确证据，可能仅靠提示性推断。
安全与权限 10/20: 代码支持通过 --header 和 --oauth2Bearer 传递认证头，但文档警告可能是真实令牌，未发现硬编码秘密。无恶意行为迹象。但存在潜在风险：允许任意 Origin（--cors 无值）可能增加跨站请求风险；且未能完全审查依赖和供应链安全，因此评分降至10。
维护活跃度 14/20: 仓库活跃，有大量贡献者，许可证为 MIT，有持续提交和发布（npx 包），但未提供具体提交频率或安全问题响应渠道的明确证据。因此得14分，扣除部分原因是对治理和版本管理缺乏充分证据。
文档质量 15/20: README 全面，覆盖安装、配置、示例（Docker、Claude Desktop、Cursor）、高级用法和测试，但缺少故障排除和明确的功能限制（如会话超时、并发限制）的文档。此外，文档宣称某些功能但未提供验证证据，因此评分15。
安装易用性 14/20: 安装简单（npx 一行命令），提供了 Docker 镜像和多个客户端集成示例。但需要用户自行配置环境（如 Node 24+，虽然官方镜像可以避免），且设置支持多种路径，可能增加复杂度。由于未执行验证，评分不超过15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Node.js 24+ · Docker

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

验证是否装好

运行 npx -y supergateway --stdio "uvx mcp-server-git" 后，用 MCP Inspector 连接 http://localhost:8000/sse，若能列出工具和资源即说明网关正常工作。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

通过 supergateway 把 filesystem MCP 服务器以 SSE 方式暴露在 8000 端口
用 --sse 连接远程 supermachine MCP 服务器并在本地通过 stdio 使用
以 Streamable HTTP 有状态模式启动 supergateway 并设置会话超时为 60000 毫秒

使用场景

将本地 stdio MCP 服务器暴露为 SSE 或 WebSocket 服务，以便远程访问。

将远程 SSE 或 Streamable HTTP MCP 服务器转换为本地 stdio，以便在命令行环境中使用。

通过 ngrok 或 Docker 部署，实现公共访问。

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

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