mcp server fs

Local 2025-09-01 00:52:24 0

This server provides an interface for performing basic file system operations such as navigation, reading, writing, and file analysis, allowing users to manage directories and files efficiently.

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

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.