punkpeye/mcp-remote

解决的问题

许多Model Context Protocol (MCP)客户端（如Claude Desktop、Cursor和Windsurf）目前仅限于本地（stdio）连接。这使用户无法轻松连接到远程的、基于Web托管的MCP服务器。mcp-remote充当桥梁，允许这些本地客户端通过HTTP/SSE连接到远程服务器，同时处理必要的认证和协议转换。

工作原理

mcp-remote是一个代理，您可以在MCP客户端的设置中配置它。它拦截连接，管理OAuth流程（包括令牌存储和刷新），并处理协议转换。它支持现代MCP功能，如授权、自定义标头和协议版本桥接（允许旧版客户端与无状态的现代服务器通信）。

适用对象

此工具适用于希望将远程托管的MCP服务器与尚不支持远程或认证MCP连接的桌面AI应用程序一起使用的开发者和高级用户。

亮点

• 无缝集成：可作为标准MCP配置文件中的直接替代品。
• 认证支持：处理复杂的OAuth流程、自定义标头以及通过文件进行的安全凭证管理。
• 协议桥接：使用自动协商模式，实现旧版MCP客户端与现代无状态服务器之间的通信。
• 高度可配置：提供广泛的CLI标志，用于网络超时、传输策略（SSE/HTTP）、代理支持和工具过滤。