What operations can Filesystem MCP Server perform?
It can read, write, edit, move, and delete files and directories. It also supports listing directory contents, searching for files, and retrieving file metadata.
Filesystem MCP Server
@javillegasna
Basic information
About Filesystem MCP Server
Simple and secure file system mcp server
Filesystem MCP Server config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryFilesystem MCP Server tools
10Read complete contents of a file
Read multiple files simultaneously
Create new file or overwrite existing (exercise caution with this)
Make selective edits using advanced pattern matching and formatting
Create new directory or ensure it exists
List directory contents with [FILE] or [DIR] prefixes
Move or rename files and directories
Recursively search for files/directories
Get detailed file/directory metadata
List all directories the server is allowed to access
Overview
What is Filesystem MCP Server?
Filesystem MCP Server is a Python server that implements the Model Context Protocol (MCP) for filesystem operations. It allows tools to read, write, and manage files and directories within explicitly allowed paths. It is designed for AI assistants and other MCP clients that need controlled file system access.
How to use Filesystem MCP Server?
The server is started as an MCP server and requires the allowed directories to be specified via command-line arguments. Once connected, an MCP client can invoke the provided tools (e.g., read_file, write_file, list_directory) to perform filesystem operations within those directories.
Key features of Filesystem MCP Server
- Read and write files with UTF-8 encoding
- Selective file editing with pattern matching and dry-run preview
- Create, list, and delete directories recursively
- Move or rename files and directories
- Recursive file search with glob-style exclusion patterns
- Get detailed file metadata (size, times, permissions)
Use cases of Filesystem MCP Server
- An AI assistant reads and edits source code files in a project directory
- Automated file management: create directories, move files, and list contents
- Search for files matching a pattern across a subdirectory tree
- Preview and apply targeted edits to configuration or documentation files
Frequently asked questions
Which directories can the server access?
Only directories explicitly specified when starting the server via the `args` parameter. The tool `list_allowed_directories` shows which directories are accessible.
Can edits be previewed before applying?
Yes. The `edit_file` tool has a `dryRun` parameter (boolean). When set to `true`, it returns detailed diff and match information without modifying the file.
How does the file editing feature work?
It supports line-based and multi-line content matching with whitespace normalization and indentation preservation. Multiple edits can be applied simultaneously, and the tool maintains correct positioning.
What happens if I move a file to a destination that already exists?
The `move_file` tool fails if the destination path already exists. It will not overwrite an existing file or directory.
More Files & Storage MCP servers
Bulk Filesystem Operations MCP Server
strawgateMCP Server for reading many files at the same time
25
Filesystem MCP Server SSE
ysthinkThe SSE version of the MCP service is modified from the Filesystem MCP server
17
Storacha MCP Storage Server
storachaStoracha MCP storage server - self-sovereign data for your AI applications.
13
Filesystem MCP Server
cyanheadsA Model Context Protocol (MCP) server for platform-agnostic file capabilities, including advanced search/replace and directory tree traversal
42
mcp-rquest
xxxbrianA MCP server providing realistic browser-like HTTP request capabilities with accurate TLS/JA3/JA4 fingerprints for bypassing anti-bot measures. It also supports converting PDF and HTML documents to Markdown for easier processing by LLMs.
48
Comments