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 和可配置的网络超时，防止空闲连接被中断。