Advanced filesystem operations for Claude Desktop with large file handling capabilities and Claude-optimized features. Add to your Claude Desktop config. - Basic setup - With backup files enabled Control backup file creation behavior. - CREATEBACKUPFILES=false (default): Disables backup file creation to reduce clutter - CREATEBACKUPFILES=true: Creates backup files before modifications Note: Backup
Add this skill
npx mdskills install efforthye/fast-filesystem-mcpComprehensive filesystem MCP with excellent tool coverage, chunking, streaming, and detailed setup docs
1<!-- # fast-filesystem-mcp -->2<!-- <img width="1460" height="82" alt="image" src="https://github.com/user-attachments/assets/d77b4f8a-2d21-4645-9584-39ae9c7a2c26" /> -->3<img width="860" height="92" alt="image" src="https://github.com/user-attachments/assets/f4a8dfea-e922-4306-b769-48337681f5ea" />4Advanced filesystem operations for Claude Desktop with large file handling capabilities and Claude-optimized features.56## Quick Start7Add to your Claude Desktop config.8- **Basic setup**9```json10{11 "mcpServers": {12 "fast-filesystem": {13 "command": "npx",14 "args": ["-y", "fast-filesystem-mcp"]15 }16 }17}18```1920- **With backup files enabled**21```json22{23 "mcpServers": {24 "fast-filesystem": {25 "command": "npx",26 "args": ["-y", "fast-filesystem-mcp"],27 "env": {28 "CREATE_BACKUP_FILES": "true"29 }30 }31 }32}33```3435### Backup Configuration36Control backup file creation behavior.37- `CREATE_BACKUP_FILES=false` (default): Disables backup file creation to reduce clutter38- `CREATE_BACKUP_FILES=true`: Creates backup files before modifications3940**Note**: Backup files are created with timestamps (e.g., `file.txt.backup.1755485284402`) to prevent data loss during edits.4142### Debug and Logging Configuration43The MCP server uses a safe logging system that prevents JSON-RPC communication errors.44- `DEBUG_MCP=true` or `MCP_DEBUG=true`: Enable debug logging to stderr45- `MCP_LOG_FILE=/path/to/log.txt`: Write logs to file instead of stderr46- `MCP_SILENT_ERRORS=true` or `SILENT_ERRORS=true`: Suppress error messages in responses4748**Note**: Debug output is automatically suppressed by default to prevent JSON parsing errors in Claude Desktop.4950## New Version Update51To update to the latest version, follow these steps.521. **Uninstall previous version**53 ```bash54 npm uninstall -g fast-filesystem-mcp55 ```562. **Clean cache and dependencies**57 ```bash58 npm cache clean --force59 pnpm store prune60 ```613. **Install latest version**62 ```bash63 npm install -g fast-filesystem-mcp64 ```654. **Verify installation**66 ```bash67 npm list -g fast-filesystem-mcp68 fast-filesystem-mcp --version69 ```7071## Features72### Core File Operations73- Fast File Reading/Writing: Optimized for Claude Desktop with chunking support74- Sequential Reading: Read large files completely with continuation token support75- Large File Handling: Stream-based writing for files of any size76- Directory Operations: Comprehensive directory listing, creation, and management77- File Search: Name and content-based file searching with filtering7879### Advanced Capabilities80- Pagination Support: Handle large directories efficiently81- Chunked Reading: Read large files in manageable chunks82- Streaming Writes: Memory-efficient writing for large files83- Backup & Recovery: Automatic backup creation and error recovery84- Retry Logic: Built-in retry mechanism for reliable operations8586### Performance Optimizations87- Claude-Optimized: Response sizes and formats optimized for Claude88- Memory Efficient: Streaming operations prevent memory overflow89- Smart Exclusions: Automatically excludes system files and directories90- Progress Tracking: Real-time progress monitoring for large operations9192## Available Tools93### File Operations94| Tool | Description |95|------|-------------|96| `fast_read_file` | Read files with chunking support |97| `fast_read_multiple_files` | Read multiple files simultaneously with sequential reading support |98| `fast_write_file` | Write or modify files |99| `fast_large_write_file` | Stream-based writing for large files |100| `fast_get_file_info` | Get detailed file information |101102### Complex File Management103| Tool | Description |104|------|-------------|105| `fast_copy_file` | Copy files and directories with advanced options |106| `fast_move_file` | Move/rename files and directories safely |107| `fast_delete_file` | Delete files and directories with protection |108| `fast_batch_file_operations` | Execute multiple file operations in sequence |109110### Archive Management111| Tool | Description |112|------|-------------|113| `fast_compress_files` | Create compressed archives (tar, tar.gz, tar.bz2) |114| `fast_extract_archive` | Extract compressed archives with options |115116### Directory Synchronization117| Tool | Description |118|------|-------------|119| `fast_sync_directories` | Advanced directory synchronization with multiple modes |120121### Advanced Editing Tools122| Tool | Description |123|------|-------------|124| `fast_edit_file` | Precise line-based file editing with multiple modes |125| `fast_edit_block` | Safe block editing with exact string matching |126| `fast_edit_blocks` | Batch block editing for multiple precise changes |127| `fast_edit_multiple_blocks` | Edit multiple sections in a single operation |128| `fast_extract_lines` | Extract specific lines or ranges from files |129130### Directory Operations131| Tool | Description |132|------|-------------|133| `fast_list_directory` | List directory contents with pagination |134| `fast_create_directory` | Create directories recursively |135| `fast_get_directory_tree` | Get directory tree structure |136137### Search Operations138| Tool | Description |139|------|-------------|140| `fast_search_files` | Search files by name or content |141| `fast_search_code` | Advanced code search with ripgrep integration |142| `fast_find_large_files` | Find large files in directories |143144### System Operations145| Tool | Description |146|------|-------------|147| `fast_get_disk_usage` | Check disk usage information |148| `fast_list_allowed_directories` | List allowed directories |149150## Editing Tools151### Precise File Editing152The fast-filesystem MCP now includes powerful editing tools for source code and text files.153#### `fast_edit_file` - Single Block Editing154Supports multiple editing modes.155- **replace**: Replace text or entire lines156- **replace_range**: Replace multiple lines at once157- **insert_before**: Insert content before specified line158- **insert_after**: Insert content after specified line159- **delete_line**: Delete specific lines160161```json162{163 "tool": "fast_edit_file",164 "arguments": {165 "path": "/path/to/file.js",166 "mode": "replace",167 "line_number": 10,168 "new_text": "const newVariable = 'updated value';",169 "backup": true170 }171}172```173174#### `fast_edit_multiple_blocks` - Batch Editing175Edit multiple parts of a file in a single operation.176```json177{178 "tool": "fast_edit_multiple_blocks",179 "arguments": {180 "path": "/path/to/file.js",181 "edits": [182 {183 "mode": "replace",184 "old_text": "oldFunction()",185 "new_text": "newFunction()"186 },187 {188 "mode": "insert_after",189 "line_number": 5,190 "new_text": "// Added comment"191 }192 ],193 "backup": true194 }195}196```197198#### `fast_extract_lines` - Line Extraction199Extract specific lines by number, range, or pattern.200```json201{202 "tool": "fast_extract_lines",203 "arguments": {204 "path": "/path/to/file.js",205 "pattern": "function.*",206 "context_lines": 2207 }208}209```210211#### `fast_search_and_replace` - Advanced Replace212Powerful search and replace with regex support.213214```json215{216 "tool": "fast_search_and_replace",217 "arguments": {218 "path": "/path/to/file.js",219 "search_pattern": "console\\.log\\(.*\\)",220 "replace_text": "logger.info($1)",221 "use_regex": true,222 "max_replacements": 10,223 "backup": true224 }225}226```227228### Editing Features229- **Automatic Backup**: Creates backups before modifications230- **Error Recovery**: Restores from backup on failure231- **Line-based Operations**: Precise control over specific lines232- **Pattern Matching**: Regular expression support233- **Batch Operations**: Multiple edits in single transaction234- **Context Extraction**: Extract lines with surrounding context235236### Large File Writing237- `fast_large_write_file`238 - Streaming: Writes files in chunks to prevent memory issues239 - Backup: Automatically creates backups before overwriting240 - Verification: Verifies file integrity after writing241 - Retry Logic: Automatic retry on failure with exponential backoff242 - Progress Tracking: Real-time monitoring of write progress243244## License245Apache 2.0246247Copyright 2025 efforthye248249Licensed under the Apache License, Version 2.0 (the "License");250you may not use this file except in compliance with the License.251You may obtain a copy of the License at252253Unless required by applicable law or agreed to in writing, software254distributed under the License is distributed on an "AS IS" BASIS,255WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.256See the License for the specific language governing permissions and257limitations under the License.258259## Badge260<a href="https://glama.ai/mcp/servers/@efforthye/fast-filesystem-mcp">261 <img width="280" height="150" src="https://glama.ai/mcp/servers/@efforthye/fast-filesystem-mcp/badge" />262</a><br/>263<a href="https://mseep.ai/app/efforthye-fast-filesystem-mcp">264 <img height="150" src="https://mseep.net/pr/efforthye-fast-filesystem-mcp-badge.png" alt="MseeP.ai Badge" />265</a><br/>266267[](https://mseep.ai/app/eb4a3f2f-f985-4efb-8dc2-3d319cf9b361)<br/>268269## Repository270https://github.com/efforthye/fast-filesystem-mcp271
Full transparency — inspect the skill content before installing.