Filesystem MCP Server

copy_path

Copies a file or directory to a new location. Accepts relative or absolute paths. Defaults to recursive copy for directories.

move_path

Moves or renames a file or directory. Accepts relative or absolute paths for source and destination.

read_file

Reads the entire content of a specified file as UTF-8 text. Accepts relative or absolute paths. Relative paths are resolved against the session default set by `set_filesystem_default`.

list_files

Lists files and directories within the specified directory. Optionally lists recursively and returns a tree-like structure. Includes an optional `maxEntries` parameter (default 50) to limit the number of items returned.

write_file

Writes content to a specified file. Creates the file (and necessary directories) if it doesn't exist, or overwrites it if it does. Accepts relative or absolute paths (resolved like readFile).

delete_file

Removes a specific file. Accepts relative or absolute paths.

update_file

Performs targeted search-and-replace operations within an existing file using an array of {search, replace} blocks. Preferred for smaller, localized changes. For large-scale updates or overwrites, consider using `write_file`. Accepts relative or absolute paths. File must exist. Supports optional `useRegex` (boolean, default false) and `replaceAll` (boolean, default false).

create_directory

Creates a directory. Optionally creates parent directories. Accepts relative or absolute paths.

delete_directory

Removes a directory. Optionally removes recursively. Accepts relative or absolute paths.

set_filesystem_default

Sets a default absolute path for the current session. Relative paths used in other filesystem tools (like readFile) will be resolved against this default. The default is cleared on server restart.