What is Filesystem Mcp Server

The filesystem-mcp-server is a Model Context Protocol (MCP) server designed to provide filesystem operations specifically for Claude AI, enabling efficient file management and manipulation.

Use cases

Use cases include file management for AI models, automated data processing tasks, and systems that require dynamic file access and manipulation, such as content management systems and cloud storage solutions.

How to use

To use the filesystem-mcp-server, clone the repository, install the dependencies using ‘npm install’, and build the project with ‘npm run build’. Run the server by specifying one or more allowed directories as command-line arguments.

Key features

Key features include reading and writing files, creating directories, listing directory contents, moving files, searching for files, retrieving file metadata, and listing accessible directories. It supports simultaneous file operations and handles errors gracefully.

Where to use

The filesystem-mcp-server can be used in various fields where file operations are required, particularly in AI applications, data processing, and environments that require structured file management.

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:

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