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

Related MCP server: Terminal MCP Server

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:

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

MCP Configuration

Add the server to your MCP configuration file:

{
  "mcpServers": {
    "filesystem-server": {
      "command": "node",
      "args": [
        "/path/to/filesystem-server/build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

License

ISC