Filesystem Features
- •Read and write file operations
- •Directory creation and listing
- •File and directory movement
- •File search capabilities
- •Metadata retrieval
- •Advanced pattern matching
- •Secure access controls
- •Whitespace normalization
- •Git-style diff output
Filesystem Setup & Configuration
Requirements
- •Node.js
- •Docker (for containerized usage)
- •Claude Desktop
- •Specified allowed directories
Installation Instructions
# Docker Installation
docker build -t mcp/filesystem -f src/filesystem/Dockerfile .
docker run -i --rm --mount type=bind,src=/path/to/dir,dst=/projects/dir mcp/filesystem /projects
# NPX Installation
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dirConfiguration
# Docker Configuration
{
"mcpServers": {
"filesystem": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
"--mount", "type=bind,src=/path/to/other/dir,dst=/projects/other/dir,ro",
"mcp/filesystem",
"/projects"
]
}
}
}
# NPX Configuration
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}Filesystem Available Tools
- •
read_file - •
read_multiple_files - •
write_file - •
edit_file - •
create_directory - •
list_directory - •
move_file - •
search_files - •
get_file_info - •
list_allowed_directories
Filesystem Required Inputs
path
- Type
- string
- Description
- File or directory path
- Required
- Yes
content
- Type
- string
- Description
- Content for file operations
- Required
- No
pattern
- Type
- string
- Description
- Search pattern
- Required
- No
edits
- Type
- array
- Description
- List of edit operations
- Required
- No
source
- Type
- string
- Description
- Source path for move operations
- Required
- No
destination
- Type
- string
- Description
- Destination path for move operations
- Required
- No
Filesystem Use Cases
- •File system management
- •Content editing and updating
- •Directory organization
- •File search and discovery
- •Metadata inspection
- •Batch file operations
- •File system automation
Frequently Asked Questions
A Node.js server implementing Model Context Protocol (MCP) for filesystem operations with secure access controls. Provides comprehensive file and directory management capabilities within specified directories.
Node.js, Docker (for containerized usage), Claude Desktop, Specified allowed directoriesView detailed requirements
Follow the installation instructions in the setup section above.View installation guide
Filesystem MCP provides the following tools:
- •
read_file - •
read_multiple_files - •
write_file - •
edit_file - •
create_directory - •
list_directory - •
move_file - •
search_files - •
get_file_info - •
list_allowed_directories
