Enables filesystem operations on Linux systems, including reading/writing files, managing directories, and searching files with specific run instructions for Linux environments.
Supports filesystem operations on macOS, with specific run instructions for accessing and manipulating files and directories on Apple's operating system.
Provides a Node.js server implementation of the MCP protocol for filesystem operations, enabling reading, writing, and managing files and directories.
Filesystem MCP Server SSE
Node.js server SSE implementing Model Context Protocol (MCP) for filesystem operations.
Features
Read/write files
Create/list/delete directories
Move files/directories
Search files
Get file metadata
Note: The server will only allow operations within directories specified via args
.
API
Resources
file://system
: File system operations interface
Tools
read_file
Read complete contents of a file
Input:
path
(string)Reads complete file contents with UTF-8 encoding
read_multiple_files
Read multiple files simultaneously
Input:
paths
(string[])Failed reads won't stop the entire operation
write_file
Create new file or overwrite existing (exercise caution with this)
Inputs:
path
(string): File locationcontent
(string): File content
edit_file
Make selective edits using advanced pattern matching and formatting
Features:
Line-based and multi-line content matching
Whitespace normalization with indentation preservation
Multiple simultaneous edits with correct positioning
Indentation style detection and preservation
Git-style diff output with context
Preview changes with dry run mode
Inputs:
path
(string): File to editedits
(array): List of edit operationsoldText
(string): Text to search for (can be substring)newText
(string): Text to replace with
dryRun
(boolean): Preview changes without applying (default: false)
Returns detailed diff and match information for dry runs, otherwise applies changes
Best Practice: Always use dryRun first to preview changes before applying them
create_directory
Create new directory or ensure it exists
Input:
path
(string)Creates parent directories if needed
Succeeds silently if directory exists
list_directory
List directory contents with [FILE] or [DIR] prefixes
Input:
path
(string)
move_file
Move or rename files and directories
Inputs:
source
(string)destination
(string)
Fails if destination exists
search_files
Recursively search for files/directories
Inputs:
path
(string): Starting directorypattern
(string): Search patternexcludePatterns
(string[]): Exclude any patterns. Glob formats are supported.
Case-insensitive matching
Returns full paths to matches
get_file_info
Get detailed file/directory metadata
Input:
path
(string)Returns:
Size
Creation time
Modified time
Access time
Type (file/directory)
Permissions
list_allowed_directories
List all directories the server is allowed to access
No input required
Returns:
Directories that this server can read/write from
Run & Usage
Local
1. build:
2.1 run Windows:
allowed directories: C:\Users\User
2.2 run Macos / Linux:
allowed directories: /Users
3. config:
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Node.js server implementing Model Context Protocol (MCP) for filesystem operations, allowing AI systems to read, write, edit files and manage directories within specified allowed paths.
Related MCP Servers
- AsecurityAlicenseAqualityNode.js server implementing Model Context Protocol (MCP) for filesystem operations.Last updated -14135,90769,726MIT License
- -securityFlicense-qualityNode.js server implementing Model Context Protocol for filesystem operations, allowing Claude to read, write, and manipulate files and directories in specified locations.
- -securityAlicense-qualityA Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.Last updated -610MIT License
- -securityFlicense-qualityA Node.js server that implements Model Context Protocol (MCP) for controlling HWP (Korean word processor) documents, allowing AI assistants like Claude to create and manipulate Hangul documents.Last updated -159