Filesystem MCP Server
A Model Context Protocol (MCP) server that provides filesystem operations for Claude AI.
Features
This MCP server provides the following filesystem operations:
- read_file: Read complete contents of a file
- Input:
path
(string) - Reads complete file contents with UTF-8 encoding
- Input:
- read_multiple_files: Read multiple files simultaneously
- Input:
paths
(string[]) - Failed reads won't stop the entire operation
- Input:
- write_file: Create new file or overwrite existing
- Inputs:
path
(string): File locationcontent
(string): File content
- Inputs:
- create_directory: Create new directory or ensure it exists
- Input:
path
(string) - Creates parent directories if needed
- Succeeds silently if directory exists
- Input:
- list_directory: List directory contents with [FILE] or [DIR] prefixes
- Input:
path
(string)
- Input:
- move_file: Move or rename files and directories
- Inputs:
source
(string)destination
(string)
- Fails if destination exists
- Inputs:
- search_files: Recursively search for files/directories
- Inputs:
path
(string): Starting directorypattern
(string): Search pattern
- Case-insensitive matching
- Returns full paths to matches
- Inputs:
- get_file_info: Get detailed file/directory metadata
- Input:
path
(string) - Returns:
- Size
- Creation time
- Modified time
- Access time
- Type (file/directory)
- Permissions
- Input:
- list_allowed_directories: List all directories the server is allowed to access
- No input required
- Returns directories that this server can read/write from
Security
The server only allows operations within directories specified via command-line arguments.
Installation
- Clone this repository
- Install dependencies:
npm install
- Build the project:
npm run build
Usage
Run the server with one or more allowed directories:
MCP Configuration
Add the server to your MCP configuration file:
License
ISC
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.
An MCP server that allows Claude AI to perform filesystem operations including reading, writing, listing, moving files, and searching directories within specified allowed paths.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.Last updated -14TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that provides tools for reading, writing, and editing files on the local filesystem.Last updated -11,241PythonApache 2.0
- -securityAlicense-qualityAn MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.Last updated -163PythonMIT License
- AsecurityFlicenseAqualityA MCP server that allows searching for files in the filesystem based on path fragments, returning file metadata including name, path, size, and creation date.Last updated -1Python