MCP File System Server

MCP server providing file system operations. Supports navigation, reading, writing, analyzing files and command execution.

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.

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!