supercorp-ai/supergateway

解决的问题

Supergateway 提供了一种方法，来桥接 Model Context Protocol (MCP) 所使用的不同通信协议之间的差距。具体来说，它允许用户通过 Server-Sent Events (SSE)、WebSockets (WS) 和 Streamable HTTP 等基于 Web 的协议，来运行仅支持标准输入/输出 (stdio) 的 MCP 服务器，从而实现远程访问、更易于调试，以及与不支持 stdio 的客户端进行集成。

工作原理

它作为一个传输层转换器。根据配置，它可以执行以下转换：

• stdio $\to$ SSE/WS/Streamable HTTP：将本地 MCP stdio 服务器公开为网络服务。
• SSE/Streamable HTTP $\to$ stdio：连接到远程 MCP 服务器并将其在本地公开为 stdio 服务器，这对于将远程服务器集成到本地 CLI 环境或 AI 助手（如 Claude Desktop 和 Cursor）非常有用。

适用对象

正在构建或使用 MCP 服务器，且需要将其工具公开给远程客户端、使用 Web 工具（如 MCP Inspector）对服务器进行调试，或将远程 MCP 服务器集成到本地 AI 代理中的开发人员。

亮点

• 多协议支持：支持 SSE、WebSockets 和 Streamable HTTP（无状态和有状态）。
• 灵活部署：可以通过 npx、Docker 或作为本地安装来运行。
• 身份验证支持：包含用于添加自定义标头和 OAuth2 Bearer 令牌的标志，以确保远程连接的安全。
• 集成就绪：专门配置为易于与 Claude Desktop 和 Cursor 搭配使用。
• CORS 和健康检查：内置对启用 CORS 和注册健康检查端点的支持。