Fast Filesystem

This MCP server extension provides fast filesystem operations optimized for Claude Desktop, with large-file handling, safe backups, and robust editing and search capabilities. It exposes a simple, reusable way to run a local MCP service that your client can connect to for high-performance file work.

How to use

To use this MCP server, configure a local MCP client to start the server via a stdio command and point the client at the corresponding runtime. You can run the server with an inline command that uses npx to launch the fast-filesystem-mcp package, enabling optional backup behavior through environment variables. The server supports safe backups, debug logging, and silent errors to keep responses clean during development or operation.

How to install

Prerequisites you need before installing: an up-to-date Node.js runtime and npm. You will install the MCP server globally so your client can start it on demand.

npm install -g fast-filesystem-mcp

npm --version

npx --version

fast-filesystem-mcp --version

Configuration and usage notes

Basic startup configuration uses an inline command to run the MCP server through npx. The server name in configuration is fast-filesystem. You can enable backups by setting the CREATE_BACKUP_FILES environment variable to true.

Example startup configuration you can place in your client config as a reference:

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

Notes on debugging, backups, and error handling

Debug options let you emit diagnostic information to stderr or a log file. You can enable debug logging during development and direct logs to a file if you prefer persistent records. By default, debug output is suppressed to avoid JSON parsing issues in Claude environments.

Backup files are created with timestamps to prevent data loss during edits. You can enable or disable backups using CREATE_BACKUP_FILES. When backups are enabled, a file like file.txt.backup.1755485284402 is created before modifications.

If you encounter errors in responses, you can enable silent errors to suppress error details in responses, which may be helpful in stable production environments.

New version update

To update to the latest version, run these steps in sequence to ensure a clean install and verify the update.

# Uninstall the previous version
npm uninstall -g fast-filesystem-mcp

# Clean cache and dependencies
npm cache clean --force
pnpm store prune

# Install the latest version
npm install -g fast-filesystem-mcp

# Verify installation
npm list -g fast-filesystem-mcp
fast-filesystem-mcp --version

Troubleshooting

If you cannot connect to the MCP server, verify that the global binary is installed and that your client points to the correct command and arguments. Check that the backup and debug environment variables are set if you rely on those features. Review the logs if you enabled MCP_LOG_FILE to ensure the server started correctly and is listening for connections.

Security and best practices

Limit exposure of the MCP server by running it in a controlled environment and use environment variables to toggle optional features like backups or verbose logs. Keep dependencies up to date and monitor disk usage, especially when performing large file operations or directory scans.

Available tools

fast_read_file

Read files with chunking support for large files without loading entire contents into memory.

fast_read_multiple_files

Read multiple files concurrently with sequential reading support.

fast_write_file

Write or modify files with efficient buffering and safety checks.

fast_large_write_file

Stream-based writing for very large files with progress tracking.

fast_get_file_info

Obtain detailed metadata about a file.

fast_copy_file

Copy files and directories with options for safety and performance.

fast_move_file

Move or rename files and directories with safeguards.

fast_delete_file

Delete files and directories with protective checks.

fast_batch_file_operations

Execute multiple file operations in a single batch.

fast_compress_files

Create compressed archives (tar, tar.gz, tar.bz2) from files.

fast_extract_archive

Extract compressed archives with options.

fast_sync_directories

Synchronize directory trees with multiple modes.

fast_edit_file

Precise line-based 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.

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 within directories.

fast_get_disk_usage

Check disk usage information for monitoring.

fast_list_allowed_directories

List directories allowed for operations.