https://github.com/kvas-it/mcp-server-fs
MCP server providing basic file system operations. Supports navigation, reading, writing, and analyzing files.
https://github.com/kvas-it/mcp-server-fs
Last synced: about 2 months ago
JSON representation
MCP server providing basic file system operations. Supports navigation, reading, writing, and analyzing files.
- Host: GitHub
- URL: https://github.com/kvas-it/mcp-server-fs
- Owner: kvas-it
- Created: 2025-01-31T23:02:29.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-03-03T12:39:40.000Z (10 months ago)
- Last Synced: 2025-03-03T13:39:21.633Z (10 months ago)
- Language: Python
- Size: 25.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- metorial-index - File System Server - Provide basic file system operations including navigation, reading, writing, and analyzing files, as well as executing commands related to file management. (File Management)
README
# 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.