MCP 参考服务器安全更新:修复版本与升级步骤
官方参考服务器 v2.4.0于 11 月 11 日发布,修复 Filesystem、Git 和 Fetch 的六项漏洞:1 项 High、3 项 Moderate、2 项 Low。升级应针对宿主实际启动的包,随后重启并验证一次只读调用。这是参考服务器的修复,与 MCP 协议修订版分开。
这六项公告的最低修复基线是 Filesystem 2.3.0、Git 2026.11.11、Fetch 2026.11.11。仓库 tag v2.4.0 不是三个包共同的安装版本。以下事实和固定 tag 说明核对于 2026 年 11 月 17 日,后续新版需另行核对。
哪些版本受影响?
| 包与公告 | 严重性 | 受影响版本 | 修复版本及变化 |
|---|---|---|---|
@modelcontextprotocol/server-filesystem:GHSA-p9cv-8g75-4xcg | Moderate | <2.3.0,以及日期版本 2025.1.14~2026.8.31 | 2.3.0:符号链接竞态期间,读取仍固定在已检查的目录 |
| 同包:GHSA-7m4x-rv66-mxhh | Moderate | 同上 | 2.3.0:固定移动操作的来源,防止目录被替换后把界外文件移进允许目录 |
mcp-server-git:GHSA-6hqx-gqrx-c5r2 | High | <2026.11.11 | 2026.11.11:覆盖可触发外部程序的仓库配置;只读操作也可能受旧问题影响 |
| 同包:GHSA-q74p-4wrc-q7w6 | Moderate | >=2026.10.28, <2026.11.11 | 2026.11.11:拒绝通过 alternates、linked worktree 和 Git 目录符号链接越过仓库边界 |
mcp-server-fetch:GHSA-3rxj-6jhw-qfv7 | Low | >=2026.10.10, <2026.11.11 | 2026.11.11:修正 fec0::/10 被误判为公网地址的问题 |
| 同包:GHSA-f9hh-cmx9-2f23 | Low | >=0.6.1, <2026.11.11 | 2026.11.11:统一 robots.txt 规则检查时的路径规范化 |
旧版本不在某一项公告范围内,不表示它不受其他公告影响。Git 的问题意味着仅禁用写工具、设置 --repository,仍不足以阻止仓库配置触发命令。Fetch 地址公告没有证明可利用云元数据的实际攻击链;robots.txt 问题是抓取约束绕过,不是鉴权绕过或任意代码执行。
1. 找到宿主实际启动的进程
在本机检查服务器条目的 command、参数、工作目录和可执行文件路径。项目 npm 依赖、全局 npm 包、npx、Python 虚拟环境、uvx 环境和容器可能各自解析到不同代码。更新其中一个,不会更新其他实例。查询版本不需要分享完整客户端配置或环境变量。
| 启动方式 | 怎么查 | 应更新哪个对象 |
|---|---|---|
| 项目 npm 依赖 | 在启动器项目执行 npm ls @modelcontextprotocol/server-filesystem | 在该项目安装显式版本,保留 lockfile |
| 全局 npm 可执行文件 | npm ls -g @modelcontextprotocol/server-filesystem,再核对宿主使用的可执行文件 | 只有实际使用全局安装时才运行全局更新 |
npx | 检查宿主配置的包参数 | 固定该条目中的包版本;项目或全局升级不会改写它 |
| Python 模块 / pip | 用启动器指定的 Python 查询包元数据 | 更新同一解释器的环境 |
uvx / uv tool | 检查 uvx 具体参数,或用 uv tool list 查询已安装工具 | 修改 uvx 版本,或重装对应 uv tool;另一个环境里的 pip 无效 |
| Docker / 源码 | 记录实际镜像 digest / 源码 revision,以及其中的包和 Git 版本 | 使用来源可追溯的修复构建并重建容器,不从 latest 推断内容 |
2. 固定正确的包版本
Filesystem:npm 与 npx
如果使用项目依赖,在启动服务器的项目内执行:
npm install @modelcontextprotocol/[email protected]
npm ls @modelcontextprotocol/server-filesystem全局安装对应 npm install -g @modelcontextprotocol/[email protected],用 npm ls -g @modelcontextprotocol/server-filesystem 检查。只有宿主确实启动该全局可执行文件时才采用此方式。
日期版本陷阱: npm 会把 2026.8.31 等日期版本排在 2.3.0 之上,普通自动更新可能保留受影响版本。显式指定 @2.3.0 是本次发行说明给出的迁移方法。
如果宿主通过 npx 启动,保留实际允许目录,使用以下包参数:
{
"command": "npx",
"args": ["-y", "@modelcontextprotocol/[email protected]", "/absolute/path/to/allowed-directory"]
}使用前替换目录。先选一个只含普通文本文件的专用测试目录,将敏感文件留在目录之外。把条目合入宿主要求的配置结构,不要用它替换整个配置文件。
Git 与 Fetch:Python 环境
使用宿主实际启动的同一个解释器运行,例如其虚拟环境里的绝对 Python 路径:
python -m pip show mcp-server-git mcp-server-fetch
python -m pip install --upgrade mcp-server-git==2026.11.11 mcp-server-fetch==2026.11.11
python -c 'from importlib.metadata import version; print("git", version("mcp-server-git")); print("fetch", version("mcp-server-fetch"))'
git --version若该解释器没有 pip,用它对应的环境管理器安装相同的固定版本。只有同时使用两个包时才需要都安装。修复后的 Git 服务器要求 Git ≥2.31,旧 Git 下会拒绝工具调用。
uvx 方式应在实际宿主条目中固定版本,例如 Git:
{
"command": "uvx",
"args": ["mcp-server-git==2026.11.11", "--repository", "/absolute/path/to/test-repository"]
}Fetch 使用 "args": ["mcp-server-fetch==2026.11.11"]。在所选 uvx 环境查询包元数据,不要查询系统 Python:
uvx --from mcp-server-git==2026.11.11 python -c 'from importlib.metadata import version; print(version("mcp-server-git"))'
uvx --from mcp-server-fetch==2026.11.11 python -c 'from importlib.metadata import version; print(version("mcp-server-fetch"))'若使用 uv tool,先检查 uv tool list;显式重装示例为 uv tool install --force mcp-server-git==2026.11.11 和 uv tool install --force mcp-server-fetch==2026.11.11。保留原有工具专属解释器及依赖选项。它们与 uvx 是不同的安装。
Docker 与源码构建参考固定 tag 的 Git、Fetch和 Filesystem说明。检查实际运行环境内的包版本和 Git,不在这里假定某个日期 Docker tag 一定存在。
3. 重启并验证只读调用
修改前在本机备份对应配置条目。停止旧服务器,重启宿主或其 MCP 连接,避免升级前的进程继续处理请求。按 Inspector 指南使用配置中的原样命令连接并列出工具。不要假定每个服务器都有 --version 参数:还应检查启动环境的包元数据。
| 服务器 | 无害正例 | 边界检查 |
|---|---|---|
| Filesystem | 读取允许目录内的已知测试文件 | 请求读取允许目录外的无害测试文件,应被拒绝 |
| Git | 对自行创建的临时仓库调用 git_status | 对 --repository 外另一临时仓库请求状态,应被拒绝 |
| Fetch | 请求自己控制的 URL,确认返回预期文本 | robots / 地址策略用受控夹具,不访问真实元数据服务来测试公告 |
安装成功、列工具成功都只证明升级链的一部分。一次普通读取和边界拒绝不能复现符号链接竞态、恶意 Git 配置或 Fetch 的两项漏洞;漏洞回归结论需与这些 smoke 检查分开。
若启动失败,先保持该服务器停用,再查解释器、固定版本、可执行文件路径、Git 版本与旧进程。恢复配置备份不能默默重新启用已知易受攻击的包。
残余限制与验证范围
Windows 上 Filesystem 的修复缩小了目录竞态窗口,但未完全消除;Git 的修复未覆盖 directory junction。Git 配置修复针对不可信仓库级设置,不能解释为隔离一切可信全局配置。当不可信主体能修改底层目录时,仍需使用权限受限的运行环境与账号,允许目录设置本身不是完整沙箱。
2026 年 11 月 17 日实测环境:macOS 26.6.2 arm64、Python 3.11.12、Node.js 26.13.0、Git 2.54.0、Python MCP SDK 2.3.0。上述固定版本的 Filesystem、Git、Fetch 均通过 stdio 初始化并列出工具,协商协议为 2025-11-25。7 项 smoke 检查全部通过:允许目录内读取/目录外拒绝、样例仓库状态/仓库外拒绝、受控 Fetch 成功/robots 拒绝/默认私网地址拒绝。Fetch 正例夹具显式放行 loopback;默认地址策略由另一个服务器实例验证。这些检查不能证明六项漏洞在所有环境下均已消除。
Filesystem 使用本地 npm 项目包启动,Git 和 Fetch 使用隔离环境的 Python 模块启动;上文两条 uvx 包元数据查询命令也已原样运行成功。npx 与 uvx 宿主启动示例、全局 npm 安装、原样 pip 安装命令、uv tool 重装、Docker、源码构建和 Windows 本轮未运行。未升级任何现有用户 MCP 配置。
协议层的鉴权与传输要求继续看 MCP 服务器最佳实践;宿主周边权限见本地服务器安全指南。