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
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
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
- -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 -229PythonMIT License
- -securityFlicense-qualityAn MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.Last updated -46Python
- -securityAlicense-qualityA comprehensive MCP (Model Context Protocol) server for file system operations, providing Claude and other AI assistants with access to local files and directories.Last updated -1PythonMIT License
- AsecurityAlicenseAqualityAn MCP server that allows Claude AI to search, explore, and compare arXiv papers efficiently through a custom-built local server.Last updated -44PythonMIT License