punkpeye/mcp-remote

解決的問題

許多流行的模型上下文協定（MCP）客戶端（例如 Claude Desktop、Cursor 和 Windsurf）僅支援透過 stdio 傳輸的本機伺服器。這導致它們無法連接到需要 HTTP/SSE 和安全 OAuth 授權流程的遠端 MCP 伺服器。mcp-remote 作為一座橋樑，讓這些僅支援 stdio 的客戶端能連接到遠端且已授權的 MCP 伺服器。

如何運作

它作為一個本機代理運作，透過 npx 呼叫。客戶端使用 stdio 與 mcp-remote 通訊，mcp-remote 將這些請求轉譯為對遠端伺服器的 HTTP/SSE 呼叫。它處理 OAuth 授權流程，包括管理權杖、重新整理流程和自訂標頭，甚至可作為「雙時代客戶端」，透過重寫請求與管理訂閱，將舊版 MCP 客戶端與現代（2026-07-28）伺服器連接起來。

適用對象

希望使用遠端 MCP 伺服器，但又不想在自己機器上本地執行伺服器程式碼的 Claude Desktop、Cursor 或 Windsurf 等 MCP 客戶端使用者。

主要特色

• 認證支援：完全支援 OAuth 流程，包括自訂授權參數、資源指示符（RFC 8707）和客戶端憑證。
• 協定橋接：可自動在舊版（2025-11-25）與現代版（2026-07-28）MCP 協定版本之間轉換。
• 彈性設定：支援透過 CLI 或檔案設定自訂標頭、代理設定，以及使用萬用字元模式忽略特定工具。
• 傳輸控制：可選擇 http-first、sse-first、http-only 或 sse-only 等傳輸策略。
• 連線穩定性：包含心跳 ping 和可設定的網路逾時，防止閒置連線被中斷。