@modelcontextprotocol/server-filesystem

MCP Filesystem Server by Model Context Protocol

MCP server for filesystem access

Live Registry Versionv2.0.0Previous: v1.0.0Published 2026-10-19

Stability Grade

B (78/100)

90-Day Velocity

3 releases

Stable release cadence

Dependencies

5 direct

NPM manifest

License

SEE LICENSE IN LICENSE

Verified on NPM

Recommended Exact Pin: npx -y @modelcontextprotocol/server-filesystem@2.0.0

NPM Registry ->GitHub Repo ->

TL;DR Verdict & Quick Citation Summary (2026-10-24)Source: AgentBreakWatch Live NPM Index

MCP Filesystem Server (@modelcontextprotocol/server-filesystem) is currently at v2.0.0 on NPM (published 2026-10-19), with a 90-day stability score of 78/100 (B) and HIGH schema drift risk across 3 releases in the past 90 days. Major v2.0.0 release enforces roots protocol capabilities, tightens symlink path traversal validation, and updates edit_file dryRun diff schema. Production teams should pin npx -y @modelcontextprotocol/server-filesystem@2.0.0 rather than using unpinned @latest tags.

Breaking Changes & Tool Schema Drift Analysis

Major v2.0.0 release enforces roots protocol capabilities, tightens symlink path traversal validation, and updates edit_file dryRun diff schema.

Watched Exports / MCP Tool Signatures:

read_text_fileread_multiple_filesedit_filelist_allowed_directories

Before (Deprecated / Unpinned Pattern)

// tools/call: read_file (legacy alias)
{ "name": "read_file", "arguments": { "path": "/workspace/app.ts" } }

After (Verified v2.0.0 Pattern)

// tools/call: read_text_file (v2.0.0+)
{ "name": "read_text_file", "arguments": { "path": "/workspace/app.ts", "head": 200 } }

Frequently Asked Questions: @modelcontextprotocol/server-filesystem

What is the latest version of @modelcontextprotocol/server-filesystem on NPM?

As of 2026-10-24, the latest stable version of @modelcontextprotocol/server-filesystem (MCP Filesystem Server by Model Context Protocol) on NPM is v2.0.0, published on 2026-10-19. It has shipped 3 releases in the last 90 days.

Does @modelcontextprotocol/server-filesystem v2.0.0 have breaking changes or MCP schema drift risk?

@modelcontextprotocol/server-filesystem currently carries a HIGH schema drift risk rating with a Stability Score of 78/100 (Grade B). Major v2.0.0 release enforces roots protocol capabilities, tightens symlink path traversal validation, and updates edit_file dryRun diff schema.

How do I safely pin @modelcontextprotocol/server-filesystem in production?

Avoid unpinned @latest tags in production agent configs. Pin the exact verified version using `npx -y @modelcontextprotocol/server-filesystem@2.0.0` and monitor read_text_file, read_multiple_files, edit_file, list_allowed_directories for parameter or schema changes.

30-Min Registry & Schema Poller

Get Instant Breaking-Change Alerts for @modelcontextprotocol/server-filesystem

We poll NPM and modelcontextprotocol/servers every 30 minutes. Get an email with the exact diff when @modelcontextprotocol/server-filesystem ships a breaking release beyond v2.0.0.