The Model Context Protocol (MCP) reference-server v2.5.0 release introduces security updates across three distinct server packages. These updates strengthen security boundaries within the Git, filesystem, and everything servers. This guidance provides a technical overview of the necessary upgrades and the specific mechanics of the addressed vulnerabilities.
Operators should verify their current versions against the following affected and fixed ranges:
A specific upgrade challenge exists for the filesystem package. Because the project previously used date-based versioning (e.g., 2025.x, 2026.x) and transitioned to semantic versioning at 1.0.0, package managers rank the new 2.4.0 version below every 2025.x and 2026.x version. Consequently, these will not be offered as automatic upgrades for installations using date-based versioning. To update, users must run: npm install @modelcontextprotocol/server-filesystem@2.4.0.
The release addresses six Git-related advisories by tightening how the server interacts with repository configurations:
gc.recentObjectsHook, potentially executing hooks with server privileges. The update sets maintenance.auto=false and gc.auto=0 for all Git commands. (Maintenance fix)GIT_NO_LAZY_FETCH=1 and rejects promisor remotes if the Git version is too old to support this flag. (Fetch fix)--repository confinement check is not yet repeated after such a write. (Driver fix)git_status disclose path existence under --repository. The server now validates index paths and disables the untracked cache. (Index fix)diff.submodule=short, overrides drivers, and refuses Git versions older than 2.33 for repositories with checked-out submodules. (Submodule fix)The filesystem server update addresses a vulnerability where directory listing functions—specifically list_directory, list_directory_with_sizes, directory_tree, and search_files—could follow a symlink swap. A symlink swap occurs when a directory is replaced by a symbolic link after validation, potentially returning entries outside the intended scope. The fix anchors these listings on Linux and macOS; however, the release notes specify that listings are not yet anchored on Windows.
The everything server fix addresses a NAT64-related issue. NAT64 is a mechanism that allows IPv6-only networks to communicate with IPv4-only servers. Previously, the gzip-file-as-resource feature treated certain IPv6 addresses in the 64:ff9b::/96 range as public, which could allow a URL to reach a private IPv4 address when using a NAT64 gateway. The update now correctly validates the embedded IPv4 address.