The Filesystem MCP Server is a Node.js server that implements the Model Context Protocol (MCP) for performing various filesystem operations. It provides a robust API for reading, writing, and editing files, as well as managing directories. The server supports advanced file editing with features like pattern matching, whitespace normalization, and fuzzy matching, making it ideal for complex file manipulations. It also offers functionalities to move files, search directories, and retrieve file metadata. The server is restricted to operate within specified directories to ensure security. This project is useful for developers who need to automate or manage filesystem tasks programmatically within a controlled environment.
Read complete contents of a file. Input: `path` (string). Reads complete file contents with UTF-8 encoding.
Read multiple files simultaneously. Input: `paths` (string[]). Failed reads won't stop the entire operation.
Create new file or overwrite existing. Inputs: `path` (string): File location, `content` (string): File content.
Make selective edits using advanced pattern matching and formatting. Inputs: `path` (string): File to edit, `edits` (array): List of edit operations, `dryRun` (boolean): Preview changes without applying (default: false), `options` (object): Optional formatting settings.
Create new directory or ensure it exists. Input: `path` (string). Creates parent directories if needed.
List directory contents with [FILE] or [DIR] prefixes. Input: `path` (string).
Move or rename files and directories. Inputs: `source` (string), `destination` (string). Fails if destination exists.
Recursively search for files/directories. Inputs: `path` (string): Starting directory, `pattern` (string): Search pattern, `excludePatterns` (string[]): Exclude any patterns.
Get detailed file/directory metadata. Input: `path` (string). Returns size, creation time, modified time, access time, type, and permissions.
List all directories the server is allowed to access. No input required. Returns directories that this server can read/write from.
No reviews yet. Be the first to review!
Sign in to join the conversation
Highlight AIAfter downloading, you can run the MCP server in any client or IDE:
node path/to/downloaded/file.mjs