Filesystem
About
Implements an extensive list of filesystem operations for navigating, reading, writing, and analyzing files, enabling efficient file management and content generation tasks.
Details
- Author
- kvas-it
- Repository
- kvas-it/mcp-server-fs
- GitHub stars
- 3
- Downloads
- 479
- Categories
- Productivity, Developer Tools, Design, File Management, AI, Project Management, Infrastructure, Other
- Tags
- #integration
Jump to
- List, read, write, copy, move, and delete files and directories
- Search files with regex patterns using grep
- Edit files with multiple search/replace operations
- Analyze Python and Markdown files for structure
- Run shell commands with a configurable timeout
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
FilesystemCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The server exposes tools under categories such as file and directory operations, editing and searching, analysis, batch operations, project navigation, code quality, and command execution. Users invoke these tools (e.g., ls, read_file, write_file, grep, summary, ruff_check, shell_command) by name with the required parameters.
ls
List directory contents. Parameters: path (string)
cd
Change working directory. Parameters: path (string)
read_file
Read file contents. Parameters: path (string)
write_file
Write content to a file. Parameters: path (string), content (string)
mkdir
Create directory. Parameters: path (string)
rm
Remove file or empty directory. Parameters: path (string)
rmdir
Remove directory and contents recursively. Parameters: path (string)
cp
Copy file or directory. Parameters: src (string), dst (string)
mv
Move file or directory. Parameters: src (string), dst (string)
edit_file
Apply multiple search/replace operations to a file. Parameters: path (string), changes (list of tuples)
grep
Search for regex pattern in file(s). Parameters: pattern (string), path (string)
summary
Generate summary of Python (.py) and Markdown (.md) files. Parameters: path (string)
read_files
Read multiple files, returns dict mapping paths to contents. Parameters: paths (list of strings)
summarize
Generate summaries for multiple files, returns dict mapping paths to summaries. Parameters: paths (list of strings)
work_on
Change to directory, list its contents, and get the notes from CLAUDE.md. Parameters: path (string)
ruff_check
Run ruff linter on specified files. Parameters: paths (list of strings)
ruff_format
Format files using ruff. Parameters: paths (list of strings)
shell_command
Run shell commands and capture their output. Parameters: command (string), args (optional), cmdline (optional), timeout (optional, default is 30)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"filesystem": {
"env": {},
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}
}
}Linux
{
"env": [],
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}Macos
{
"env": [],
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}Windows
{
"env": [],
"args": [
"/c",
"npx",
"-y",
"@highlight/mcp-server"
],
"command": "cmd"
}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.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
