MCPgee
MCPgee
MCPgeeMCPgee

Fast Filesystem

v1.0.0•File Systems•stable

📇 🏠 🍎 🪟 🐧 - Advanced filesystem operations with large file handling capabilities and Claude-optimized features. Provides fast file reading/writing, sequential reading for large files, directory operations, file search, and streaming writes with backu

ai-assistantai-toolsanthropicautomationbackup
Share:
51
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Fast Filesystem?

Fast Filesystem is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 🏠 🍎 🪟 🐧 - advanced filesystem operations with large file handling capabilities and claude-optimized features. provides fast file reading/writing, sequential reading for large files, directory o...

📇 🏠 🍎 🪟 🐧 - Advanced filesystem operations with large file handling capabilities and Claude-optimized features. Provides fast file reading/writing, sequential reading for large files, directory operations, file search, and streaming writes with backu

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 📇 🏠 🍎 🪟 🐧 - Advanced filesystem operations with large file h

Use Cases

Large file handling and streaming
Optimized filesystem operations for AI
efforthye

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx fast-filesystem

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Fast Filesystem

fast-filesystem-mcp is an advanced filesystem MCP server for Claude Desktop that goes well beyond basic file read/write. It provides chunked reading with continuation tokens for files too large to fit in a single response, streaming writes for large files, a full suite of precise editing tools (line-based, block-based, and batch multi-block edits), directory synchronization, archive creation and extraction, ripgrep-powered code search, and automatic backup creation before modifications. It is cross-platform (macOS, Windows, Linux) and is optimized specifically for Claude's response-size constraints.

Prerequisites

  • Node.js 18 or later
  • Claude Desktop or another MCP-compatible client
  • npx available (bundled with Node.js via npm)
  • Optional: ripgrep (rg) installed for the fast_search_code tool's full code-search capabilities
1

Open your Claude Desktop configuration file

On macOS the config is at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it is at %APPDATA%\Claude\claude_desktop_config.json. Open it in a text editor.

2

Add the fast-filesystem-mcp server entry

Insert the mcpServers entry. The -y flag tells npx to automatically accept the package install prompt so the server starts without interaction.

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

(Optional) Enable automatic backup files

Set the CREATE_BACKUP_FILES environment variable to true if you want the server to create timestamped backups before modifying any file. Backups are saved alongside the original with a .backup.<timestamp> suffix.

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

Restart Claude Desktop

Close and reopen Claude Desktop. The fast-filesystem server will start automatically via npx and its tools (fast_read_file, fast_write_file, fast_search_files, etc.) will appear in the tool list.

5

(Optional) Configure debug logging

To troubleshoot issues, enable debug logging by setting DEBUG_MCP=true. Logs go to stderr by default; redirect them to a file with MCP_LOG_FILE to keep them out of Claude's JSON-RPC channel.

"env": {
  "DEBUG_MCP": "true",
  "MCP_LOG_FILE": "/tmp/fast-filesystem-debug.log"
}

Fast Filesystem Examples

Client configuration

Recommended Claude Desktop config with backup files enabled. Remove the env block entirely if you do not want backups.

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

Prompts to try

Prompts that exercise the advanced file operations this server provides.

- "Read the file /var/log/app.log in 500-line chunks and summarize each section"
- "Search all .ts files under ~/projects/myapp for usages of the deprecated 'getUser' function"
- "Replace every occurrence of 'oldApiEndpoint' with 'newApiEndpoint' in ~/projects/myapp/src/config.ts"
- "Create a tar.gz archive of ~/projects/myapp/dist and save it to ~/backups/myapp-dist.tar.gz"
- "List all files larger than 50MB under ~/Downloads"
- "Sync the contents of ~/projects/staging to ~/projects/production, deleting files that no longer exist in staging"

Troubleshooting Fast Filesystem

Claude Desktop shows JSON parsing errors or the server fails to start

This usually happens when debug output leaks into stdout and corrupts the JSON-RPC stream. Ensure DEBUG_MCP is not set, or if you need debug output, set MCP_LOG_FILE to redirect it to a file. The package defaults to silent logging to prevent this issue.

fast_search_code returns limited results or errors about 'rg' not found

The code-search tool uses ripgrep (rg) for best results. Install it with 'brew install ripgrep' on macOS or 'apt install ripgrep' on Debian/Ubuntu. If ripgrep is absent, the tool may fall back to slower grep-based search or skip certain features.

The server is using a stale version of the package

npx caches packages. To force the latest version, run 'npm uninstall -g fast-filesystem-mcp && npm cache clean --force', then restart Claude Desktop to pull a fresh copy via npx.

Frequently Asked Questions about Fast Filesystem

What is Fast Filesystem?

Fast Filesystem is a Model Context Protocol (MCP) server that 📇 🏠 🍎 🪟 🐧 - advanced filesystem operations with large file handling capabilities and claude-optimized features. provides fast file reading/writing, sequential reading for large files, directory operations, file search, and streaming writes with backu It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Fast Filesystem?

Follow the installation instructions on the Fast Filesystem GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Fast Filesystem?

Fast Filesystem works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Fast Filesystem free to use?

Yes, Fast Filesystem is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Fast Filesystem Alternatives — Similar File Systems Servers

Looking for alternatives to Fast Filesystem? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File SystemsBrowse All Servers

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Fast Filesystem?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides