fast-filesystem-mcp
Advanced filesystem operations and large file management for Claude Desktop environments.
Key Features
Use Cases
README
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 clutterCREATE_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=trueorMCP_DEBUG=true: Enable debug logging to stderrMCP_LOG_FILE=/path/to/log.txt: Write logs to file instead of stderrMCP_SILENT_ERRORS=trueorSILENT_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.
- Uninstall previous version
bash
npm uninstall -g fast-filesystem-mcp - Clean cache and dependencies
bash
npm cache clean --force pnpm store prune - Install latest version
bash
npm install -g fast-filesystem-mcp - Verify installation
bash
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 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 |
Advanced Editing Tools
| Tool | Description |
|---|---|
fast_edit_file |
Precise line-based file editing with multiple modes |
fast_edit_block |
Safe block editing with exact string matching |
fast_edit_blocks |
Batch block editing for multiple precise changes |
fast_edit_multiple_blocks |
Edit multiple sections in a single operation |
fast_extract_lines |
Extract specific lines or ranges from files |
Directory Operations
| Tool | Description |
|---|---|
fast_list_directory |
List directory contents with pagination |
fast_create_directory |
Create directories recursively |
fast_get_directory_tree |
Get directory tree structure |
Search Operations
| Tool | Description |
|---|---|
fast_search_files |
Search files by name or content |
fast_search_code |
Advanced code search with ripgrep integration |
fast_find_large_files |
Find large files in directories |
System Operations
| Tool | Description |
|---|---|
fast_get_disk_usage |
Check disk usage information |
fast_list_allowed_directories |
List allowed directories |
Editing Tools
Precise File Editing
The fast-filesystem MCP now includes powerful editing tools for source code and text files.
fast_edit_file - Single Block Editing
Supports multiple editing modes.
- replace: Replace text or entire lines
- replace_range: Replace multiple lines at once
- insert_before: Insert content before specified line
- insert_after: Insert content after specified line
- delete_line: Delete specific lines
{
"tool": "fast_edit_file",
"arguments": {
"path": "/path/to/file.js",
"mode": "replace",
"line_number": 10,
"new_text": "const newVariable = 'updated value';",
"backup": true
}
}
fast_edit_multiple_blocks - Batch Editing
Edit multiple parts of a file in a single operation.
{
"tool": "fast_edit_multiple_blocks",
"arguments": {
"path": "/path/to/file.js",
"edits": [
{
"mode": "replace",
"old_text": "oldFunction()",
"new_text": "newFunction()"
},
{
"mode": "insert_after",
"line_number": 5,
"new_text": "// Added comment"
}
],
"backup": true
}
}
fast_extract_lines - Line Extraction
Extract specific lines by number, range, or pattern.
{
"tool": "fast_extract_lines",
"arguments": {
"path": "/path/to/file.js",
"pattern": "function.*",
"context_lines": 2
}
}
fast_search_and_replace - Advanced Replace
Powerful search and replace with regex support.
{
"tool": "fast_search_and_replace",
"arguments": {
"path": "/path/to/file.js",
"search_pattern": "console\\.log\\(.*\\)",
"replace_text": "logger.info($1)",
"use_regex": true,
"max_replacements": 10,
"backup": true
}
}
Editing Features
- Automatic Backup: Creates backups before modifications
- Error Recovery: Restores from backup on failure
- Line-based Operations: Precise control over specific lines
- Pattern Matching: Regular expression support
- Batch Operations: Multiple edits in single transaction
- Context Extraction: Extract lines with surrounding context
Large File Writing
fast_large_write_file- Streaming: Writes files in chunks to prevent memory issues
- Backup: Automatically creates backups before overwriting
- Verification: Verifies file integrity after writing
- Retry Logic: Automatic retry on failure with exponential backoff
- Progress Tracking: Real-time monitoring of write progress
License
Apache 2.0
Copyright 2025 efforthye
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Badge
Repository
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Topics
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
MCP RSS Aggregator
Fetch and read RSS feeds in Claude Desktop via Model Context Protocol.
MCP RSS Aggregator enables Claude Desktop to access and display content from user-selected RSS feeds using the Model Context Protocol (MCP). It supports OPML and JSON formats for managing feed configurations, allowing users to import or customize their subscriptions easily. The tool organizes feeds by categories, filters content from different sources, and presents articles with well-formatted titles, snippets, and links. Integration with Claude Desktop allows seamless aggregation and delivery of real-time news content for users.
- ⭐ 16
- MCP
- imprvhub/mcp-rss-aggregator
Netwrix Access Analyzer MCP Server
An MCP server integrating enterprise access analysis tools with Claude Desktop.
Netwrix Access Analyzer MCP Server provides a Model Context Protocol (MCP) server designed for integration with Claude Desktop. It enables secure and dynamic access to Active Directory, SQL Server databases, and file system data for auditing and analysis. The server offers a range of tools for effective group membership discovery, permission analysis, sensitive data detection, and more. It streamlines enterprise security assessments by standardizing context-sharing for AI-driven solutions.
- ⭐ 1
- MCP
- netwrix/mcp-server-naa
RivalSearchMCP
Advanced MCP server for web research, discovery, and trend analysis.
RivalSearchMCP is an advanced Model Context Protocol (MCP) server designed to streamline web research, content discovery, and trend analysis. It offers tools for multi-engine web search, intelligent content retrieval, website analysis, and AI-driven content insights. The platform includes integrated trends analysis, research workflows with progress tracking, and automated generation of LLMs.txt documentation files. Its anti-detection features, real-time content streaming, and flexible data export options make it ideal for complex research and automation workflows.
- ⭐ 10
- MCP
- damionrashford/RivalSearchMCP
Apple Books MCP
Model Context Protocol server for integrating and managing Apple Books data with AI assistants.
Apple Books MCP is a server implementation of the Model Context Protocol (MCP) that enables AI assistants to access, organize, and interact with Apple Books data such as collections, books, highlights, notes, and annotations. It provides standardized tools for retrieving and searching book-related data, supporting integration with platforms like Claude Desktop. Designed for easy setup with Python or uv, it facilitates context-aware AI capabilities for reading and annotation workflows.
- ⭐ 33
- MCP
- vgnshiyer/apple-books-mcp
Ebook-MCP
A Model Context Protocol server for conversational e-book interaction and AI integration.
Ebook-MCP acts as a Model Context Protocol (MCP) server enabling seamless interaction between large language model (LLM) applications and electronic books such as EPUB and PDF. It standardizes APIs for AI-powered reading, searching, and managing digital libraries. Through natural language interfaces, it provides smart library management, content navigation, and interactive learning within digital books. Ebook-MCP integrates with modern AI-powered IDEs and supports multi-format digital book processing.
- ⭐ 132
- MCP
- onebirdrocks/ebook-mcp
WebSearch-MCP
Real-time web search for AI assistants via Model Context Protocol.
WebSearch-MCP is a Model Context Protocol (MCP) server that enables real-time web search capabilities for AI assistants through the stdio transport. It connects with a web crawler API to retrieve up-to-date search results and serves these results to AI models like Claude. The solution offers straightforward configuration and seamless integration with various MCP clients, enhancing AI model access to current and relevant external information.
- ⭐ 19
- MCP
- mnhlt/WebSearch-MCP
Didn't find tool you were looking for?