地址：https://github.com/supercorp-ai/supergateway

一、项目概述

• 项目名称：Supergateway

• 核心功能：作为Model Context Protocol（MCP）协议的网关工具，支持将基于标准输入输出（stdio）的MCP服务器转换为Server-Sent Events（SSE）接口，或反向连接远程SSE服务器并提供本地stdio接口。

• 目标用户：需要远程访问本地MCP服务器、调试SSE服务，或集成不支持SSE的MCP客户端的开发者。

• 协议支持：完全兼容MCP v1协议，支持与Claude、Cursor、MCP Inspector等工具无缝协作。

二、核心功能与优势

（一）主要功能

1. 双模式通信桥接
• Stdio → SSE模式：将本地通过stdio运行的MCP服务器（如uvx mcp-server-git）暴露为SSE端点，供远程客户端（如Web应用）通过HTTP请求订阅事件。
• SSE → Stdio模式：连接到远程SSE服务器（如云托管的MCP服务），并将其转换为本地stdio接口，供传统MCP客户端（如Claude Desktop）使用。

2. 灵活配置
• 支持自定义端口、基础URL、SSE路径（默认/sse）和消息路径（默认/message）。
• 支持CORS（跨域资源共享）配置，方便前端集成。

3. 高级特性
• 健康检查端点：自定义/healthz端点，用于服务状态监测。
• 日志控制：通过-logLevel参数设置日志级别（info或none）。
• Docker支持：提供官方Docker镜像，简化部署流程。

（二）技术优势

• 协议转换：无缝衔接stdio与SSE协议，降低工具链兼容性门槛。

• 轻量化：仅需Node.js环境，无需复杂配置即可运行。

• 安全性：支持CORS配置，可限制非法跨域请求。

• 生态兼容：适配主流MCP客户端（Claude、Cursor）和调试工具（MCP Inspector）。

三、安装与使用

（一）安装方式

1. 通过npx直接运行
• -stdio：指定本地stdio运行的MCP服务器命令。
• -port：Supergateway监听的端口（默认8000）。

2. Docker运行

（二）配置示例（Claude Desktop集成）

四、使用场景与示例

（一）典型应用场景

1. 远程访问本地MCP服务器
• 本地运行mcp-server-git，通过Supergateway暴露为SSE端点，供居家办公的团队成员通过HTTPS访问。

2. 调试SSE服务
• 使用MCP Inspector通过Supergateway的SSE端点调试远程MCP服务器：

3. 集成云托管MCP服务
• 将云服务商的SSE托管服务（如AWS Lambda）通过Supergateway转换为本地stdio接口，供Claude Desktop直接调用。

（二）使用示例

1. 启动stdio到SSE网关

2. 通过SSE获取文件列表

3. Docker容器化部署

五、技术细节与扩展性

（一）协议转换原理

• Stdio → SSE：通过Node.js的EventSource库将stdio的输入输出流转换为SSE事件流，客户端通过HTTP长轮询接收实时数据。

• SSE → Stdio：反向代理远程SSE事件到本地stdio，模拟终端交互（如键盘输入、输出捕获）。

（二）扩展性设计

• 模块化架构：支持自定义中间件，可扩展鉴权、日志记录等功能。

• 版本兼容：自动检测JSON-RPC协议版本，确保未来协议升级时的平滑过渡。

六、注意事项

（一）安全与权限

• 敏感信息保护：避免在命令行中明文传递API密钥，建议使用环境变量。

• 防火墙规则：生产环境中需限制SSE端点的访问IP范围。

（二）已知限制

• 单实例限制：当前版本仅支持单个MCP服务器实例，多实例需启动多个Supergateway进程。

• 性能瓶颈：高并发场景下需评估Node.js的事件循环性能。

七、最后的总结

1. 降低接入门槛：让传统MCP客户端无缝访问现代SSE服务。

2. 提升协作效率：支持远程团队协作和云原生部署。

3. 灵活扩展：适配多种工具链和部署场景。