Privacy choices: we'd like to measure visits anonymously (our own cookie-free counter plus Google Analytics, which sets its own cookies; no ads) and load Beehiiv's newsletter sign-up, which may set its own cookies. Nothing optional runs until you choose. Privacy policy

AgentScout / MCP servers / Filesystem MCP Server
MCP serversOpen sourceNewAdded Nov 9, 2026Local only

Filesystem MCP Server logoFilesystem MCP Server

No ratings yet★ Rate this tool

The official Filesystem MCP Server from the Model Context Protocol project gives Claude, Cursor, VS Code and other MCP clients sandboxed read, write, edit, search and move access to only the folders you allow, installed with npx @modelcontextprotocol/server-filesystem or the mcp/filesystem Docker image.

Updated

✨ Try AgentScout's free AI image generator →

Good for: research, connecting tools with MCP, running code safely

Use cases

Get featured

About Filesystem MCP Server

Filesystem MCP Server is listed in our MCP servers category and is aimed at builders. The official Filesystem MCP Server from the Model Context Protocol project gives Claude, Cursor, VS Code and other MCP clients sandboxed read, write, edit, search and move access to only the folders you allow, installed with npx @modelcontextprotocol/server-filesystem or the mcp/filesystem Docker image. Pricing, as the maker states it: Free and open source (MIT, moving to Apache-2.0 for new contributions). Maturity: Mature. We last checked the official link on 2026-11-09.

What is Filesystem MCP Server?

The Filesystem MCP Server is the official reference server from the Model Context Protocol project for giving an AI agent file access on your own machine. It is a Node.js server that runs locally over stdio, published on npm as @modelcontextprotocol/server-filesystem (version 2.2.0 when we checked on Nov 9, 2026) and as the mcp/filesystem Docker image. It can only touch the allowed directories you pass on the command line, and every requested path is resolved and checked against them, including paths reached through symlinks.

The README lists tools to read text files, media files and several files at once; write, append to and edit files, with a dry-run diff preview for edit_file; create and list directories, with optional file sizes; move, rename and copy files; find files by name with glob patterns; return a JSON directory tree; read file metadata; and show the allowed directories. Starting it with --read-only registers only the read and list tools. Clients on the 2025-era protocol can swap the allowed directories through MCP Roots, which is deprecated in the 2026-07-28 protocol, and --confine-roots keeps those Roots inside the command-line folders. The MCP project describes the servers in this repository as reference implementations and educational examples rather than production-ready solutions, so check its access rules against your own security needs.

Sources: github.com/modelcontextprotocol/servers/tree/main/src/filesystem, github.com/modelcontextprotocol/servers/blob/main/src/filesystem/READM, npmjs.com/package/@modelcontextprotocol/server-filesystem, modelcontextprotocol.io/examples and our directory listing, checked 2026-11-09.

Who is Filesystem MCP Server for?

Developers who want Claude Desktop, Claude Code, Cursor, VS Code or another MCP client to read and edit files in a few chosen project folders, with a hard limit on what the agent can reach.

Pros and cons

Pros

  • Maintained in the official modelcontextprotocol/servers repository and published on npm and Docker Hub.
  • The agent can only reach the folders you pass in, and a read-only mode removes every write tool.
  • edit_file can preview a git-style diff before it changes anything.

Cons

  • The MCP project calls its reference servers educational examples, not production-ready solutions.
  • write_file overwrites in place, and the README warns that hard-linked files can change outside the allowed folders.
  • search_files matches file names only, not file contents, and large trees stop at 100,000 entries.

Setup

  1. Install Node.js 24 or later, or use Docker.
  2. Add the server to your MCP client config with npx -y @modelcontextprotocol/server-filesystem followed by each folder the agent may use. With Docker, run mcp/filesystem and bind-mount the folders under /projects, adding ro for read-only mounts.
  3. Add --read-only if the agent should only read and list files.
  4. Restart the client and ask it to call list_allowed_directories to confirm which folders it can reach.

Filesystem MCP Server at a glance

Key features

  • Read text, media and multiple files; write, append and edit files with a dry-run diff preview
  • Create, list, move, rename and copy files and folders; glob search by file name; JSON directory tree; file metadata
  • Access limited to the allowed directories given on the command line, checked on every path including symlinks
  • --read-only mode serves only the read and list tools; --confine-roots keeps client Roots inside your folders
  • Install with npx -y @modelcontextprotocol/server-filesystem <folders> (Node.js 24 or later) or the mcp/filesystem Docker image with folders mounted under /projects
  • Tool annotations mark read-only, idempotent and destructive tools for clients

Filesystem MCP Server MCP server

  • Endpoint: Local stdio: npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir
  • Transport: stdio (runs on your machine; Docker image mcp/filesystem)
  • Authentication: None: access is limited to the allowed directories you pass in
  • MCP Registry name: io.github.modelcontextprotocol/server-filesystem

Tools

  • read_file: Deprecated alias of read_text_file, still listed by version 2.2.0.
  • read_text_file: Read a file as UTF-8 text, optionally only the first or last N lines.
  • read_media_file: Read an image, audio or other binary file as base64 with its MIME type.
  • read_multiple_files: Read several files at once; one failed read does not stop the rest.
  • write_file: Create a file or overwrite an existing one.
  • append_file: Append text to the end of a file, creating it if needed.
  • edit_file: Make find-and-replace edits, with a dry-run mode that returns a git-style diff.
  • create_directory: Create a directory, including parent directories.
  • list_directory: List a directory's entries with [FILE] or [DIR] prefixes.
  • list_directory_with_sizes: List a directory with file sizes, sorted by name or size.
  • move_file: Move or rename a file or directory; fails if the destination exists.
  • copy_file: Copy one file to a new path; never overwrites.
  • search_files: Find files and folders by name with glob patterns (not by content).
  • directory_tree: Return a recursive JSON tree of a directory, with optional depth.
  • get_file_info: Get size, timestamps, type, permissions and hard-link count.
  • list_allowed_directories: Show the directories the server is allowed to access.

Client config (Cursor, VS Code, Claude Code and other config-file clients):

{"mcpServers": {"filesystem": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]}}}

Setup docs: github.com/modelcontextprotocol/servers/tree/main/src/filesystem. Tool list checked live on 2026-11-09.

Filesystem MCP Server FAQ

What is Filesystem MCP Server?

The Filesystem MCP Server is the official reference server from the Model Context Protocol project for giving an AI agent file access on your own machine. It is a Node.js server that runs locally over stdio, published on npm as @modelcontextprotocol/server-filesystem (version 2.2.0 when we checked on Nov 9, 2026) and as the mcp/filesystem Docker image. It can only touch the allowed directories you pass on the command line, and every requested path is resolved and checked against them, including paths reached through symlinks.

Who is Filesystem MCP Server for?

Developers who want Claude Desktop, Claude Code, Cursor, VS Code or another MCP client to read and edit files in a few chosen project folders, with a hard limit on what the agent can reach.

Is Filesystem MCP Server free?

Filesystem MCP Server's pricing, as the maker states it: Free and open source (MIT, moving to Apache-2.0 for new contributions). Check the official site for current plans.

Is Filesystem MCP Server open source?

Yes. Filesystem MCP Server is released under MIT, moving to Apache-2.0 for new contributions, according to its GitHub repository.

Can the Filesystem MCP Server access my whole computer?

No. It only works inside the allowed directories you pass when it starts, and the list_allowed_directories tool shows them. Clients on the older 2025-era protocol can replace that list through MCP Roots unless you start the server with --confine-roots.

Can I make the Filesystem MCP Server read-only?

Yes. Start it with --read-only and it registers only the tools that read and list files, so write_file, edit_file and the other write tools are not available. With Docker you can also mount folders with the ro flag.

What are the pros and cons of Filesystem MCP Server?

Pros: Maintained in the official modelcontextprotocol/servers repository and published on npm and Docker Hub., The agent can only reach the folders you pass in, and a read-only mode removes every write tool., edit_file can preview a git-style diff before it changes anything. Cons: The MCP project calls its reference servers educational examples, not production-ready solutions., write_file overwrites in place, and the README warns that hard-linked files can change outside the allowed folders., search_files matches file names only, not file contents, and large trees stop at 100,000 entries.

How do I set up Filesystem MCP Server?

1. Install Node.js 24 or later, or use Docker. 2. Add the server to your MCP client config with npx -y @modelcontextprotocol/server-filesystem followed by each folder the agent may use. With Docker, run mcp/filesystem and bind-mount the folders under /projects, adding ro for read-only mounts. 3. Add --read-only if the agent should only read and list files. 4. Restart the client and ask it to call list_allowed_directories to confirm which folders it can reach.

What are alternatives to Filesystem MCP Server?

Similar tools include MCP Python SDK, MCP Registry, MCP Go SDK, Mcp Teams Server, LMK.today MCP and Datagouv MCP.

Filesystem MCP Server ratings and reviews

No ratings yet. Be the first to review Filesystem MCP Server.

Be the first to rate Filesystem MCP Server: tap 1 to 5 stars below. A written review is optional.

Your rating of Filesystem MCP Server

Star ratings count right away; written reviews appear after a quick check. One rating per tool per visitor. Reviews are from site visitors, not verified users. How reviews work

Filesystem MCP Server alternatives

Other MCP servers tools in our directory. See all MCP servers tools →

Get your badge

Built Filesystem MCP Server? Optional. Showing this badge does not change your rank or earn a Featured spot. It links to this page. About badges

Listed on AgentScout (light)