3D MCP Cursor Visualization
Filesystem MCP Logo - AI-Powered Development Tool for Cursor IDE

Filesystem MCP

Model Context Protocol Integration

Overview

A Node.js server implementing Model Context Protocol (MCP) for filesystem operations with secure access controls. Provides comprehensive file and directory management capabilities within specified directories.

Filesystem Features

  • Read and write file operations
  • Directory creation and listing
  • File and directory movement
  • File search capabilities
  • Metadata retrieval
  • Advanced pattern matching
  • Secure access controls
  • Whitespace normalization
  • Git-style diff output

Filesystem Setup & Configuration

Requirements

  • Node.js
  • Docker (for containerized usage)
  • Claude Desktop
  • Specified allowed directories

Installation Instructions

# Docker Installation
docker build -t mcp/filesystem -f src/filesystem/Dockerfile .
docker run -i --rm --mount type=bind,src=/path/to/dir,dst=/projects/dir mcp/filesystem /projects

# NPX Installation
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

Configuration

# Docker Configuration
{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/dir,dst=/projects/other/dir,ro",
        "mcp/filesystem",
        "/projects"
      ]
    }
  }
}

# NPX Configuration
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Filesystem Available Tools

  • read_file
  • read_multiple_files
  • write_file
  • edit_file
  • create_directory
  • list_directory
  • move_file
  • search_files
  • get_file_info
  • list_allowed_directories

Filesystem Required Inputs

path

Type
string
Description
File or directory path
Required
Yes

content

Type
string
Description
Content for file operations
Required
No

pattern

Type
string
Description
Search pattern
Required
No

edits

Type
array
Description
List of edit operations
Required
No

source

Type
string
Description
Source path for move operations
Required
No

destination

Type
string
Description
Destination path for move operations
Required
No

Filesystem Use Cases

  • File system management
  • Content editing and updating
  • Directory organization
  • File search and discovery
  • Metadata inspection
  • Batch file operations
  • File system automation

Frequently Asked Questions

A Node.js server implementing Model Context Protocol (MCP) for filesystem operations with secure access controls. Provides comprehensive file and directory management capabilities within specified directories.
Node.js, Docker (for containerized usage), Claude Desktop, Specified allowed directoriesView detailed requirements
Follow the installation instructions in the setup section above.View installation guide

Filesystem MCP provides the following tools:

  • read_file
  • read_multiple_files
  • write_file
  • edit_file
  • create_directory
  • list_directory
  • move_file
  • search_files
  • get_file_info
  • list_allowed_directories