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 和註冊健康檢查端點的支援。