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:

1. read_file: Read complete contents of a file
   • Input: path (string)
   • Reads complete file contents with UTF-8 encoding
2. read_multiple_files: Read multiple files simultaneously
   • Input: paths (string[])
   • Failed reads won't stop the entire operation
3. write_file: Create new file or overwrite existing
   • Inputs:
     • path (string): File location
     • content (string): File content
4. create_directory: Create new directory or ensure it exists
   • Input: path (string)
   • Creates parent directories if needed
   • Succeeds silently if directory exists
5. list_directory: List directory contents with [FILE] or [DIR] prefixes
   • Input: path (string)
6. move_file: Move or rename files and directories
   • Inputs:
     • source (string)
     • destination (string)
   • Fails if destination exists
7. search_files: Recursively search for files/directories
   • Inputs:
     • path (string): Starting directory
     • pattern (string): Search pattern
   • Case-insensitive matching
   • Returns full paths to matches
8. get_file_info: Get detailed file/directory metadata
   • Input: path (string)
   • Returns:
     • Size
     • Creation time
     • Modified time
     • Access time
     • Type (file/directory)
     • Permissions
9. 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

1. Clone this repository
2. Install dependencies: npm install
3. 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