efforthye/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**
- **With backup files enabled**
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**
2. **Clean cache and dependencies**
3. **Install latest version**
4. **Verify installation**
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 Management
| Tool | Description |
|------|-------------|
| fast_compress_files | Create compressed archives (tar, tar.gz, tar.bz2) |
| fast_extract_archive | Extract compressed archives with options |
Directory Synchronization
| Tool | Description |
|------|-------------|
| fast_sync_directories | Advanced directory synchronization with multiple modes |