fast-filesystem-mcp
Schnellstart
Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu.
Grundlegende Einrichtung
{
"mcpServers": {
"fast-filesystem": {
"command": "npx",
"args": ["-y", "fast-filesystem-mcp"]
}
}
}Mit aktivierten Sicherungsdateien
{
"mcpServers": {
"fast-filesystem": {
"command": "npx",
"args": ["-y", "fast-filesystem-mcp"],
"env": {
"CREATE_BACKUP_FILES": "true"
}
}
}
}Sicherungskonfiguration
Steuern Sie das Verhalten bei der Erstellung von Sicherungsdateien.
CREATE_BACKUP_FILES=false(Standard): Deaktiviert die Erstellung von Sicherungsdateien, um Unordnung zu vermeidenCREATE_BACKUP_FILES=true: Erstellt Sicherungsdateien vor Änderungen
Hinweis: Sicherungsdateien werden mit Zeitstempeln erstellt (z. B. file.txt.backup.1755485284402), um Datenverlust bei Bearbeitungen zu verhindern.
Debug- und Protokollierungskonfiguration
Der MCP-Server verwendet ein sicheres Protokollierungssystem, das JSON-RPC-Kommunikationsfehler verhindert.
DEBUG_MCP=trueoderMCP_DEBUG=true: Aktiviert die Debug-Protokollierung nach stderrMCP_LOG_FILE=/path/to/log.txt: Schreibt Protokolle in eine Datei anstatt nach stderrMCP_SILENT_ERRORS=trueoderSILENT_ERRORS=true: Unterdrückt Fehlermeldungen in Antworten
Hinweis: Die Debug-Ausgabe wird standardmäßig automatisch unterdrückt, um JSON-Parsing-Fehler in Claude Desktop zu verhindern.
Related MCP server: Code Buddy
Update auf eine neue Version
Um auf die neueste Version zu aktualisieren, führen Sie diese Schritte aus.
Vorherige Version deinstallieren
npm uninstall -g fast-filesystem-mcpCache und Abhängigkeiten bereinigen
npm cache clean --force pnpm store pruneNeueste Version installieren
npm install -g fast-filesystem-mcpInstallation überprüfen
npm list -g fast-filesystem-mcp fast-filesystem-mcp --version
Funktionen
Grundlegende Dateioperationen
Schnelles Lesen/Schreiben von Dateien: Optimiert für Claude Desktop mit Unterstützung für Chunking
Sequentielles Lesen: Große Dateien vollständig lesen mit Unterstützung für Fortsetzungstoken
Verarbeitung großer Dateien: Stream-basiertes Schreiben für Dateien jeder Größe
Verzeichnisoperationen: Umfassende Verzeichnisauflistung, Erstellung und Verwaltung
Dateisuche: Namens- und inhaltsbasierte Dateisuche mit Filterung
Erweiterte Fähigkeiten
Paginierungsunterstützung: Große Verzeichnisse effizient verarbeiten
Chunked Reading: Große Dateien in handhabbaren Stücken lesen
Streaming-Schreibvorgänge: Speichereffizientes Schreiben für große Dateien
Sicherung & Wiederherstellung: Automatische Erstellung von Sicherungen und Fehlerwiederherstellung
Wiederholungslogik: Integrierter Wiederholungsmechanismus für zuverlässige Operationen
Leistungsoptimierungen
Claude-optimiert: Antwortgrößen und Formate für Claude optimiert
Speichereffizient: Streaming-Operationen verhindern Speicherüberläufe
Intelligente Ausschlüsse: Schließt automatisch Systemdateien und -verzeichnisse aus
Fortschrittsverfolgung: Echtzeit-Überwachung des Fortschritts bei großen Operationen
Verfügbare Tools
Dateioperationen
Tool | Beschreibung |
| Dateien mit Chunking-Unterstützung lesen |
| Mehrere Dateien gleichzeitig mit Unterstützung für sequentielles Lesen lesen |
| Dateien schreiben oder ändern |
| Stream-basiertes Schreiben für große Dateien |
| Detaillierte Dateiinformationen abrufen |
Komplexe Dateiverwaltung
Tool | Beschreibung |
| Dateien und Verzeichnisse mit erweiterten Optionen kopieren |
| Dateien und Verzeichnisse sicher verschieben/umbenennen |
| Dateien und Verzeichnisse mit Schutz löschen |
| Mehrere Dateioperationen nacheinander ausführen |
Archivverwaltung
Tool | Beschreibung |
| Komprimierte Archive erstellen (tar, tar.gz, tar.bz2) |
| Komprimierte Archive mit Optionen extrahieren |
Verzeichnissynchronisierung
Tool | Beschreibung |
| Erweiterte Verzeichnissynchronisierung mit mehreren Modi |
Erweiterte Bearbeitungstools
Tool | Beschreibung |
| Präzise zeilenbasierte Dateibearbeitung mit mehreren Modi |
| Sichere Blockbearbeitung mit exaktem String-Abgleich |
| Batch-Blockbearbeitung für mehrere präzise Änderungen |
| Mehrere Abschnitte in einer einzigen Operation bearbeiten |
| Bestimmte Zeilen oder Bereiche aus Dateien extrahieren |
Verzeichnisoperationen
Tool | Beschreibung |
| Verzeichnisinhalt mit Paginierung auflisten |
| Verzeichnisse rekursiv erstellen |
| Verzeichnisbaumstruktur abrufen |
Suchoperationen
Tool | Beschreibung |
| Dateien nach Name oder Inhalt suchen |
| Erweiterte Codesuche mit ripgrep-Integration |
| Große Dateien in Verzeichnissen finden |
Systemoperationen
Tool | Beschreibung |
| Festplattennutzungsinformationen prüfen |
| Erlaubte Verzeichnisse auflisten |
Bearbeitungstools
Präzise Dateibearbeitung
Das fast-filesystem MCP enthält jetzt leistungsstarke Bearbeitungstools für Quellcode und Textdateien.
fast_edit_file - Einzelblockbearbeitung
Unterstützt mehrere Bearbeitungsmodi.
replace: Text oder ganze Zeilen ersetzen
replace_range: Mehrere Zeilen gleichzeitig ersetzen
insert_before: Inhalt vor der angegebenen Zeile einfügen
insert_after: Inhalt nach der angegebenen Zeile einfügen
delete_line: Bestimmte Zeilen löschen
{
"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-Bearbeitung
Mehrere Teile einer Datei in einer einzigen Operation bearbeiten.
{
"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 - Zeilenextraktion
Bestimmte Zeilen nach Nummer, Bereich oder Muster extrahieren.
{
"tool": "fast_extract_lines",
"arguments": {
"path": "/path/to/file.js",
"pattern": "function.*",
"context_lines": 2
}
}fast_search_and_replace - Erweitertes Ersetzen
Leistungsstarkes Suchen und Ersetzen mit Regex-Unterstützung.
{
"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
}
}Bearbeitungsfunktionen
Automatische Sicherung: Erstellt Sicherungen vor Änderungen
Fehlerwiederherstellung: Stellt bei Fehlern aus der Sicherung wieder her
Zeilenbasierte Operationen: Präzise Kontrolle über bestimmte Zeilen
Musterabgleich: Unterstützung für reguläre Ausdrücke
Batch-Operationen: Mehrere Bearbeitungen in einer einzigen Transaktion
Kontext-Extraktion: Zeilen mit umgebendem Kontext extrahieren
Schreiben großer Dateien
fast_large_write_fileStreaming: Schreibt Dateien in Chunks, um Speicherprobleme zu vermeiden
Sicherung: Erstellt automatisch Sicherungen vor dem Überschreiben
Überprüfung: Überprüft die Dateiintegrität nach dem Schreiben
Wiederholungslogik: Automatische Wiederholung bei Fehlern mit exponentiellem Backoff
Fortschrittsverfolgung: Echtzeit-Überwachung des Schreibfortschritts
Lizenz
Apache 2.0
Copyright 2025 efforthye
Lizenziert unter der Apache License, Version 2.0 (die "Lizenz"); Sie dürfen diese Datei nur in Übereinstimmung mit der Lizenz verwenden. Sie können eine Kopie der Lizenz erhalten unter
Sofern nicht durch geltendes Recht vorgeschrieben oder schriftlich vereinbart, wird die unter der Lizenz vertriebene Software "WIE BESEHEN" bereitgestellt, OHNE GEWÄHRLEISTUNG ODER BEDINGUNGEN JEDER ART, weder ausdrücklich noch stillschweigend. Siehe die Lizenz für die spezifische Sprache, die die Berechtigungen und Einschränkungen unter der Lizenz regelt.
Badge
Repository
Available Tools
25 toolsfast_batch_file_operationsC
Performs batch operations on multiple files
Inputs: operations (required), stop_on_error, dry_run, create_backup.
fast_compress_filesC
Compresses files or directories
Inputs: paths (required), output_path (required), format, compression_level, +1 more.
fast_copy_fileC
Copies a file or directory
Inputs: source (required), destination (required), overwrite, preserve_timestamps, +2 more.
fast_create_directoryC
Creates a directory
Inputs: path (required), recursive.
fast_delete_fileC
Deletes a file or directory
Inputs: path (required), recursive, force, backup_before_delete, +1 more.
fast_edit_blockC
Precise block editing: safely replace exact matches (desktop-commander style)
Inputs: path (required), old_text (required), new_text (required), expected_replacements, +4 more.
fast_edit_blocksC
Processes multiple precise block edits at once (array of fast_edit_block)
Inputs: path (required), edits (required), backup.
fast_edit_multiple_blocksC
Edits multiple parts of a file at once
Inputs: path (required), edits (required), backup.
fast_extract_archiveC
Extracts an archive file
Inputs: archive_path (required), extract_to, overwrite, create_dirs, +2 more.
fast_extract_linesD
Extracts specific lines from a file
Inputs: path (required), line_numbers, start_line, end_line, +2 more.
fast_find_large_filesC
Finds large files
Inputs: path (required), min_size, max_results.
fast_get_directory_treeC
Gets the directory tree structure
Inputs: path (required), max_depth, show_hidden, include_files.
fast_get_disk_usageC
Gets disk usage information
Inputs: path.
fast_get_file_infoB
Gets detailed information about a file or directory
Inputs: path (required).
fast_large_write_fileA
Reliably writes large files (with streaming, retry, backup, and verification features)
Inputs: path (required), content (required), encoding, create_dirs, +6 more.
fast_list_allowed_directoriesB
Lists the allowed directories
Inputs: no named parameters.
fast_list_directoryB
Lists the contents of a directory (with auto-chunking and pagination support)
Inputs: path (required), page, page_size, pattern, +5 more.
fast_move_fileB
Moves or renames a file or directory
Inputs: source (required), destination (required), overwrite, create_dirs, +1 more.
fast_read_fileB
Reads a file (with auto-chunking support)
Inputs: path (required), start_offset, max_size, line_start, +4 more.
fast_read_multiple_filesB
Reads the content of multiple files simultaneously (supports sequential reading)
Inputs: paths (required), continuation_tokens, auto_continue, chunk_size.
fast_safe_editB
Safe smart editing: Detects risks and provides interactive confirmation
Inputs: path (required), old_text (required), new_text (required), safety_level, +2 more.
fast_search_codeB
Searches for code (ripgrep-style) - provides auto-chunking, line numbers, and context
Inputs: path (required), pattern (required), file_pattern, context_lines, +6 more.
fast_search_filesB
Searches for files (by name/content) - supports auto-chunking, regex, context, and line numbers
Inputs: path (required), pattern (required), content_search, case_sensitive, +6 more.
fast_sync_directoriesC
Synchronizes two directories
Inputs: source_dir (required), target_dir (required), sync_mode, delete_extra, +3 more.
fast_write_fileC
Writes or modifies a file (provides emoji guidelines)
Inputs: path (required), content (required), encoding, create_dirs, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Most tools are distinct, but there is notable overlap between fast_edit_block, fast_safe_edit, fast_edit_multiple_blocks, and fast_edit_blocks—all handle editing and could confuse an agent. Similarly, fast_search_files and fast_search_code have overlapping purposes despite different descriptions.
The fast_ prefix is applied consistently and most tools follow a verb_noun pattern (e.g., fast_read_file, fast_create_directory). Minor deviations like fast_edit_blocks vs fast_edit_multiple_blocks and fast_batch_file_operations are slightly inconsistent but still readable.
25 tools is at the upper boundary of what is reasonable for a filesystem server. The count feels heavy because several tools overlap (multiple edit variants, two search tools, multiple read/write variants), but each has a plausible use case.
The tool surface covers the full filesystem lifecycle: read, write, edit, list, search, create, copy, move, delete, batch operations, compression, sync, and disk usage. There are no obvious dead ends for common file operations.
Maintenance
Related MCP Connectors
Cloud-hosted MCP server for durable AI memory
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Hosted MySQL MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.15305MIT
- AlicenseCqualityDmaintenanceA comprehensive MCP server that provides AI assistants with tools for file system management, Git integration, and shell command execution. It features specialized code utilities for analysis, formatting, and linting to enhance development workflows within Claude Desktop.287MIT
- AlicenseAqualityCmaintenanceA comprehensive MCP server that enables AI models to perform local file operations, command execution, and task management across multiple platforms. It features advanced capabilities like row-level file editing, directory searching, and system monitoring with built-in security filters.1348 npmMulan Permissive Software , Version 2
- AlicenseNot gradedqualityDmaintenanceA tuned filesystem MCP server for Codex-style development, offering fast file operations, bounded output, and safe edits.MIT