---
title: "Filesystem MCP reference server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/filesystem/
description: "Give a local MCP client scoped file reading, editing, search, and directory operations."
---

# Filesystem MCP reference server: review, setup & limitations · Undominated.ai

> Give a local MCP client scoped file reading, editing, search, and directory operations.

[← Explore all mcp servers](/mcp-servers/)

LOCAL FILE OPERATIONS / Model Context Protocol steering group

# Filesystem MCP reference server

Give a local MCP client scoped file reading, editing, search, and directory operations.

 [See setup guidance ↓](#setup)[Original source ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/README.md)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 7 linked sources
 Publisher Model Context Protocol steering group
 Licence [Apache-2.0 / MIT transition; documentation CC-BY-4.0 ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/LICENSE)
 Revision bbb701e7ac1e
 [Read what was—and wasn’t—checked ↓](#review)

“Node.js server implementing Model Context Protocol (MCP) for filesystem operations.”

 [Model Context Protocol steering group · upstream description ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Directory roots make the exposed filesystem scope visible to the client.
- Text, media, search, and edit tools cover ordinary workspace tasks without a SaaS account.

### A good fit for

 - Inspect and edit an explicitly approved local workspace.
- Prototype a client that supports MCP Roots.

### Weigh up before choosing

 - The publisher describes this as an educational reference implementation, not a production-ready service.
- Writes can overwrite files and move paths; this is not a read-only file browser.
- Client-supplied Roots replace the command-line allowlist, so review the client roots as well as launch arguments.
- The README says write_file and edit_file overwrite an existing file in place and are not crash-atomic: a crash mid-write can leave the file partly written.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - Current repository README and licence transition.
- src/filesystem/README.md, package.json, index.ts, server.ts and lib.ts: stdio entry point, tool registration (in server.ts at this commit) and path validation.

### Our findings

 - The server uses stdio. Its path checks include canonical paths and symlinks, but this source review is not an escape-resistance test.
- The README feature list mentions deletion, while its documented tools focus on read, write, edit, move, create, and search; this profile does not promise a separate delete tool.
- At this commit tool registration moved from index.ts to server.ts. server.ts registers read_text_file, read_media_file, read_multiple_files, write_file, edit_file, create_directory, list_directory, list_directory_with_sizes, directory_tree, move_file, search_files, get_file_info and list_allowed_directories, plus read_file marked deprecated.
- The README says that once a client’s roots are in force, a roots update with no valid roots revokes access to every path until the client exposes a root again.

### Not established by this review

 - Server launch, authenticated tool calls, and release-to-source parity were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/README.md)
 - Use the official client-specific JSON example and replace the example directory paths with a small approved workspace.
- Configure the local Node process through the MCP client; inspect list_allowed_directories after the client supplies its Roots.
- Keep write approvals enabled in the client and use OS or container permissions where stronger isolation is required.

### Before you start

 - Node.js and npm/npx.
- Read/write permission for the selected directories; an MCP client with stdio support.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "filesystem": {
 "command": "npx",
 "args": [
 "-y",
 "@modelcontextprotocol/server-filesystem",
 "/Users/username/Desktop",
 "/path/to/other/allowed/dir"
 ]
 }
 }
} Copy configuration ↗

### Compatibility

Claude Desktop · VS Code · stdio clients

### Implementation

TypeScript

### Transports

stdio

### Local process

 - Reads file contents, media, metadata and directory names within the current allowed roots.
- Creates, overwrites, edits and moves local paths using the process user’s permissions.

### Cost model

Runs on your machine; hosting and any connected model client are separate costs.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Filesystem MCP reference server setup and scope ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/README.md) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/README.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review, configExample, In-place, non-atomic overwrite, Roots revocation
- [MCP steering-group reference implementation scope ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/README.md) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/README.md Supports: publisher, upstreamDescription, limitations, review
- [Current MCP repository licence transition ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/LICENSE) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/LICENSE Supports: license, review
- [Filesystem package and executable ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/package.json) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/package.json Supports: language, install
- [Filesystem stdio entry point ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/index.ts) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/index.ts Supports: review, transports
- [Filesystem tool registrations ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/server.ts) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/server.ts Supports: review, access, Tool list, read_file registered as deprecated
- [Filesystem path checks ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/lib.ts) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/lib.ts Supports: review, limitations

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Fetch MCP reference server ↗ Retrieve a URL as text or Markdown in chunks through a small local MCP server.](/mcp-servers/fetch/)[### Git MCP reference server ↗ Inspect local Git history and diffs, then stage, commit, or switch branches through explicit tools.](/mcp-servers/git/)[### Knowledge Graph Memory reference server ↗ Persist named entities, observations and relations in a local JSONL graph between client sessions.](/mcp-servers/memory/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
