Fast Filesystem Mcp

Advanced filesystem operations for Claude Desktop with large file handling capabilities and Claude-optimized features.

Quick Start

Add to your Claude Desktop config.

• Basic setup

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"]
    }
  }
}

• With backup files enabled

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"],
      "env": {
        "CREATE_BACKUP_FILES": "true"
      }
    }
  }
}

Backup Configuration

Control backup file creation behavior.

• CREATE_BACKUP_FILES=false (default): Disables backup file creation to reduce clutter
• CREATE_BACKUP_FILES=true: Creates backup files before modifications

Note: Backup files are created with timestamps (e.g., file.txt.backup.1755485284402) to prevent data loss during edits.

Debug and Logging Configuration

The MCP server uses a safe logging system that prevents JSON-RPC communication errors.

• DEBUG_MCP=true or MCP_DEBUG=true: Enable debug logging to stderr
• MCP_LOG_FILE=/path/to/log.txt: Write logs to file instead of stderr
• MCP_SILENT_ERRORS=true or SILENT_ERRORS=true: Suppress error messages in responses

Note: Debug output is automatically suppressed by default to prevent JSON parsing errors in Claude Desktop.

New Version Update

To update to the latest version, follow these steps.

1. Uninstall previous version

   npm uninstall -g fast-filesystem-mcp
   

2. Clean cache and dependencies

   npm cache clean --force
   pnpm store prune
   

3. Install latest version

   npm install -g fast-filesystem-mcp
   

4. Verify installation

   npm list -g fast-filesystem-mcp
   fast-filesystem-mcp --version
   

Features

Core File Operations

• Fast File Reading/Writing: Optimized for Claude Desktop with chunking support
• Sequential Reading: Read large files completely with continuation token support
• Large File Handling: Stream-based writing for files of any size
• Directory Operations: Comprehensive directory listing, creation, and management
• File Search: Name and content-based file searching with filtering

Advanced Capabilities

• Pagination Support: Handle large directories efficiently
• Chunked Reading: Read large files in manageable chunks
• Streaming Writes: Memory-efficient writing for large files
• Backup & Recovery: Automatic backup creation and error recovery
• Retry Logic: Built-in retry mechanism for reliable operations

Performance Optimizations

• Claude-Optimized: Response sizes and formats optimized for Claude
• Memory Efficient: Streaming operations prevent memory overflow
• Smart Exclusions: Automatically excludes system files and directories
• Progress Tracking: Real-time progress monitoring for large operations

Available Tools

File Operations

Tool	Description
fast_read_file	Read files with chunking support
fast_read_multiple_files	Read multiple files simultaneously with sequential reading support
fast_write_file	Write or modify files
fast_large_write_file	Stream-based writing for large files
fast_get_file_info	Get detailed file information

Complex File Management

Tool	Description
fast_copy_file	Copy files and directories with advanced options
fast_move_file	Move/rename files and directories safely
fast_delete_file	Delete files and directories with protection
fast_batch_file_operations	Execute multiple file operations in sequence

Archive Mana

... View full README on GitHub