mcp-remote
活跃·★ 1.7k·MIT·更新于 2026-10-20
★ 时下流行
mcp-remote 让只支持本地 stdio 服务的 MCP 客户端可以连接远程 MCP 服务，包括需要 OAuth 的服务。README 的思路是：大多数 MCP 服务仍然安装在本地，但较新的 MCP 授权规范让服务可以托管在远程，并分享给他人使用，而不需要每个人都在自己的机器上运行代码。它称自己是可用的概念验证，并提醒应当视为实验性项目。
配置就是一条标准的 `mcpServers` 条目，运行 `npx mcp-remote <服务地址>`，在 Claude Desktop、Cursor 和 Windsurf 里用法一致。涉及的选项有：用 `--header` 传自定义或 bearer 令牌头（并附有针对客户端会弄乱 `args` 里空格的变通办法）、用 `--resource` 为同一个服务的多个实例使用独立的 OAuth 会话（比如不同的 Atlassian 租户）、给 `npx` 加 `-y` 或 `@latest`、可配置的 OAuth 回调端口、静态 OAuth 客户端元数据和客户端信息，以及传输策略。许可证为 MIT。
#MCP 协议#MCP 服务器
01
功能特性
01把 Claude Desktop、Cursor、Windsurf 等 stdio 客户端桥接到远程服务器
02支持基于 OAuth 的授权
03只需在客户端配置里写一条 npx 命令
02
为什么选择它
+解决了一个常见缺口：让只支持 stdio 的客户端使用远程 MCP 服务
+处理 OAuth 流程，并提供静态客户端信息和固定回调端口等选项
+支持自定义请求头，以及用 `--resource` 为同一服务运行多个实例
+一行 `npx` 配置即可用于 Claude Desktop、Cursor 和 Windsurf
03
权衡点
!README 称它是概念验证，应当视为实验性项目
!部分客户端会弄乱 `args` 里的空格，请求头需要用文档里的变通办法
!现在很多 MCP 客户端已原生支持远程服务，你可能不再需要它
!OAuth 凭据会保存在你的机器上，请保护好对应的目录
04
维护状况检查
活跃检查日期: 2026-10-23
- 最近提交
- 2026-10-20
- 近 90 天提交数
- 98
- 近 90 天发布数
- 30
- 最新发布
- v0.15.2 (2026-10-20)
- 未关闭 issue
- 2
- 近期 issue 至少有一条评论的比例
- 14/21
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #384 [FEATURE REQUEST] Make the listen interface configurable0 条评论 · 2026-10-23
- #382 CIMD (DCR) support0 条评论 · 2026-10-19
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
05
兼容性
Claude Desktop
客户端
已通过文档验证
Cursor
编辑器
已通过文档验证
Windsurf
编辑器
已通过文档验证
Codex
客户端
已通过文档验证
Node.js
运行时
已通过文档验证
macOS
操作系统
已通过文档验证
06
快速开始
1
$ npx mcp-remote https://example.remote/server
07
使用场景
↳在不支持远程连接的客户端里使用托管的远程 MCP 服务器
↳测试带认证的远程 MCP 服务器
08
同类工具
评论
登录后发表评论
暂无评论，来发表第一条吧