Supergateway 是一款专为 MCP（Model Context Protocol）服务器设计的远程调试与集成工具，通过 SSE（Server-Sent Events）或 WebSocket（WS）协议实现基于 stdio 的服务器与客户端的高效通信。以下是其核心功能及使用场景的详细解析：
核心功能
- 多协议支持
- 支持 SSE 和 WebSocket 双向通信，覆盖不同场景下的数据传输需求。例如，可将本地 stdio 模式的 MCP 服务器转换为 SSE/WS 服务，方便远程调试或客户端集成。
- 提供多种模式切换，如
stdio→SSE、SSE→stdio、stdio→WS，灵活适配开发与生产环境。
- 便捷部署与运行
- 本地快速启动 ：通过
npx一行命令即可运行，例如npx -y supergateway --stdio "uvx mcp-server-git"，无需复杂配置。
- Docker 支持 ：提供官方镜像
supercorp/supergateway，可在容器化环境中直接运行，避免本地 Node.js 依赖问题。
- 扩展性与稳定性
- 支持自定义健康检查端点，确保服务高可用性。
- 提供日志级别控制（
info/none）和端口自定义（默认 8000），便于监控与调试。
典型使用场景
-
远程调试 MCP 服务器 通过
--sse参数连接远程 SSE 服务器，或将本地 stdio 服务暴露为 SSE/WS 端点，实现跨网络调试。例如：npx -y supergateway --sse "https://mcp-server-xxx.supermachine.app"
-
客户端集成 若客户端仅支持 SSE/WS 协议，而 MCP 服务器基于 stdio，Supergateway 可充当中间层，实现协议转换。例如：
npx -y supergateway --stdio "npx -y @modelcontextprotocol/server-filesystem ./my-folder" --port 8000
- 云端与本地协同开发 结合 Docker 部署，可在云端快速搭建调试环境，同时通过本地工具连接进行实时交互。
docker run -it --rm -p 8000:8000 supercorp/supergateway --stdio "npx -y @modelcontextprotocol/server-filesystem /" --port 8000
项目资源
- GitHub 仓库 ：supercorp-ai/supergateway(截至 2025 年 3 月已获 490star)
- Docker 镜像 ：supercorp/supergateway
总结
Supergateway 的核心价值在于简化 MCP 服务器的远程访问与协议适配流程，尤其适合需要跨环境协作的开发者。其轻量化设计、多模式支持及容器化部署能力，使其成为 AI 模型服务调试与集成的实用工具。如需深入技术细节，建议参考官方文档或 GitHub 示例代码。