Skip to main content
Glama
fast-filesystem-mcp
by efforthye

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 vermeiden

  • CREATE_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=true oder MCP_DEBUG=true: Aktiviert die Debug-Protokollierung nach stderr

  • MCP_LOG_FILE=/path/to/log.txt: Schreibt Protokolle in eine Datei anstatt nach stderr

  • MCP_SILENT_ERRORS=true oder SILENT_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.

  1. Vorherige Version deinstallieren

    npm uninstall -g fast-filesystem-mcp
  2. Cache und Abhängigkeiten bereinigen

    npm cache clean --force
    pnpm store prune
  3. Neueste Version installieren

    npm install -g fast-filesystem-mcp
  4. Installation ü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

fast_read_file

Dateien mit Chunking-Unterstützung lesen

fast_read_multiple_files

Mehrere Dateien gleichzeitig mit Unterstützung für sequentielles Lesen lesen

fast_write_file

Dateien schreiben oder ändern

fast_large_write_file

Stream-basiertes Schreiben für große Dateien

fast_get_file_info

Detaillierte Dateiinformationen abrufen

Komplexe Dateiverwaltung

Tool

Beschreibung

fast_copy_file

Dateien und Verzeichnisse mit erweiterten Optionen kopieren

fast_move_file

Dateien und Verzeichnisse sicher verschieben/umbenennen

fast_delete_file

Dateien und Verzeichnisse mit Schutz löschen

fast_batch_file_operations

Mehrere Dateioperationen nacheinander ausführen

Archivverwaltung

Tool

Beschreibung

fast_compress_files

Komprimierte Archive erstellen (tar, tar.gz, tar.bz2)

fast_extract_archive

Komprimierte Archive mit Optionen extrahieren

Verzeichnissynchronisierung

Tool

Beschreibung

fast_sync_directories

Erweiterte Verzeichnissynchronisierung mit mehreren Modi

Erweiterte Bearbeitungstools

Tool

Beschreibung

fast_edit_file

Präzise zeilenbasierte Dateibearbeitung mit mehreren Modi

fast_edit_block

Sichere Blockbearbeitung mit exaktem String-Abgleich

fast_edit_blocks

Batch-Blockbearbeitung für mehrere präzise Änderungen

fast_edit_multiple_blocks

Mehrere Abschnitte in einer einzigen Operation bearbeiten

fast_extract_lines

Bestimmte Zeilen oder Bereiche aus Dateien extrahieren

Verzeichnisoperationen

Tool

Beschreibung

fast_list_directory

Verzeichnisinhalt mit Paginierung auflisten

fast_create_directory

Verzeichnisse rekursiv erstellen

fast_get_directory_tree

Verzeichnisbaumstruktur abrufen

Suchoperationen

Tool

Beschreibung

fast_search_files

Dateien nach Name oder Inhalt suchen

fast_search_code

Erweiterte Codesuche mit ripgrep-Integration

fast_find_large_files

Große Dateien in Verzeichnissen finden

Systemoperationen

Tool

Beschreibung

fast_get_disk_usage

Festplattennutzungsinformationen prüfen

fast_list_allowed_directories

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_file

    • Streaming: 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

Listed on Spark

Repository

https://github.com/efforthye/fast-filesystem-mcp

Available Tools

25 tools
fast_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

    C2.9/5.0

    Scored across 25 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessMostly unanswered

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      15
      305
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      A 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.
      28
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A 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.
      13
      48 npm
      Mulan Permissive Software , Version 2
    • A
      license
      Not graded
      quality
      D
      maintenance
      A tuned filesystem MCP server for Codex-style development, offering fast file operations, bounded output, and safe edits.
      MIT