MCP 参考服务器安全更新:修复版本与升级步骤

MCP 参考服务器安全更新:修复版本与升级步骤

November 17, 2026·MCP Community·技术分析·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-4xcgModerate<2.3.0,以及日期版本 2025.1.14~2026.8.312.3.0:符号链接竞态期间,读取仍固定在已检查的目录
同包:GHSA-7m4x-rv66-mxhhModerate同上2.3.0:固定移动操作的来源,防止目录被替换后把界外文件移进允许目录
mcp-server-git:GHSA-6hqx-gqrx-c5r2High<2026.11.112026.11.11:覆盖可触发外部程序的仓库配置;只读操作也可能受旧问题影响
同包:GHSA-q74p-4wrc-q7w6Moderate>=2026.10.28, <2026.11.112026.11.11:拒绝通过 alternates、linked worktree 和 Git 目录符号链接越过仓库边界
mcp-server-fetch:GHSA-3rxj-6jhw-qfv7Low>=2026.10.10, <2026.11.112026.11.11:修正 fec0::/10 被误判为公网地址的问题
同包:GHSA-f9hh-cmx9-2f23Low>=0.6.1, <2026.11.112026.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 服务器最佳实践;宿主周边权限见本地服务器安全指南。