MCP File System Server

Tools

File and Directory Operations

• `ls(path)` - List directory contents

• `cd(path)` - Change working directory (supports home directory expansion with ~)

• `read_file(path)` - Read file contents

• `write_file(path, content)` - Write content to a file

• `mkdir(path)` - Create directory

• `rm(path)` - Remove file or empty directory

• `rmdir(path)` - Remove directory and contents recursively

• `cp(src, dst)` - Copy file or directory

• `mv(src, dst)` - Move file or directory

Editing and Searching

• `edit_file(path, changes)` - Apply multiple search/replace operations to a file, where changes is a list of (search_text, replace_text) tuples

• `grep(pattern, path)` - Search for regex pattern in file(s)

Analysis

• `summary(path)` - Generate summary of Python (.py) and Markdown (.md) files: - Python: Lists functions and classes - Markdown: Lists headers (lines starting with #)

Batch Operations

• `read_files(paths)` - Read multiple files, returns dict mapping paths to contents

• `summarize(paths)` - Generate summaries for multiple files, returns dict mapping paths to summaries

Project Navigation

• `work_on(path)` - Change to directory, list its contents, and get the notes from CLAUDE.md. Useful for getting familiar with a project at the start of a chat

Code Quality

• `ruff_check(paths)` - Run ruff linter on specified files

• `ruff_format(paths)` - Format files using ruff

Command Execution

• `shell_command(command, args=None, cmdline=None, timeout=30)` - Run shell commands and capture their output > ** Security Warning**: This tool allows arbitrary command execution on the host system. Always inspect and validate commands before allowing them to run, especially if the input source is untrusted.