Filesystem MCP Server

Dateisystem MCP Server [MOD]

Node.js-Server, der das Model Context Protocol (MCP) für Dateisystemoperationen implementiert. Dies ist ein Fork von https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem

Änderungen:

• Eigenständig, keine Abhängigkeiten vom Stammprojekt
• Kann reguläre Ausdrücke verwenden, um das zulässige Verzeichnis zu definieren
• Automatische Konvertierung zwischen Schrägstrich (/) und Backslash ()

Merkmale

• Dateien lesen/schreiben
• Verzeichnisse erstellen/auflisten/löschen
• Dateien/Verzeichnisse verschieben
• Dateien suchen
• Abrufen von Dateimetadaten

Hinweis : Der Server lässt nur Vorgänge innerhalb der über args angegebenen Verzeichnisse zu.

API

Ressourcen

• file://system : Schnittstelle für Dateisystemoperationen

Werkzeuge

• Datei lesen
  • Lesen Sie den gesamten Inhalt einer Datei
  • Eingabe: path (Zeichenfolge)
  • Liest den gesamten Dateiinhalt mit UTF-8-Kodierung
• mehrere Dateien lesen
  • Mehrere Dateien gleichzeitig lesen
  • Eingabe: paths (string[])
  • Fehlgeschlagene Lesevorgänge stoppen nicht den gesamten Vorgang
• Datei schreiben
  • Neue Datei erstellen oder vorhandene überschreiben (Vorsicht dabei)
  • Eingänge:
    • path (Zeichenfolge): Dateispeicherort
    • content (Zeichenfolge): Dateiinhalt
• Datei bearbeiten
  • Nehmen Sie selektive Änderungen mithilfe erweiterter Mustererkennung und Formatierung vor
  • Merkmale:
    • Zeilenbasierter und mehrzeiliger Inhaltsabgleich
    • Leerzeichennormalisierung mit Einrückungserhaltung
    • Mehrere gleichzeitige Bearbeitungen mit korrekter Positionierung
    • Erkennung und Beibehaltung des Einrückungsstils
    • Diff-Ausgabe im Git-Stil mit Kontext
    • Vorschau der Änderungen im Probelaufmodus
  • Eingänge:
    • path (Zeichenfolge): Zu bearbeitende Datei
    • edits (Array): Liste der Bearbeitungsvorgänge
      • oldText (Zeichenfolge): Zu suchender Text (kann eine Teilzeichenfolge sein)
      • newText (Zeichenfolge): Zu ersetzender Text
    • dryRun (Boolesch): Vorschau der Änderungen ohne Anwendung (Standard: false)
  • Gibt detaillierte Diff- und Match-Informationen für Probeläufe zurück, andernfalls werden Änderungen angewendet
  • Best Practice: Verwenden Sie immer zuerst dryRun, um Änderungen in der Vorschau anzuzeigen, bevor Sie sie anwenden
• Verzeichnis erstellen
  • Neues Verzeichnis erstellen oder sicherstellen, dass es existiert
  • Eingabe: path (Zeichenfolge)
  • Erstellt bei Bedarf übergeordnete Verzeichnisse
  • Erfolgt im Hintergrund, wenn das Verzeichnis vorhanden ist
• Verzeichnisliste
  • Verzeichnisinhalte mit den Präfixen [FILE] oder [DIR] auflisten
  • Eingabe: path (Zeichenfolge)
• Datei verschieben
  • Verschieben oder Umbenennen von Dateien und Verzeichnissen
  • Eingänge:
    • source (Zeichenfolge)
    • destination (Zeichenfolge)
  • Schlägt fehl, wenn das Ziel vorhanden ist
• Suchdateien
  • Rekursive Suche nach Dateien/Verzeichnissen
  • Eingänge:
    • path (Zeichenfolge): Startverzeichnis
    • pattern (Zeichenfolge): Suchmuster
    • excludePatterns (string[]): Schließt alle Muster aus. Glob-Formate werden unterstützt.
  • Groß- und Kleinschreibung wird nicht beachtet
  • Gibt vollständige Pfade zu Übereinstimmungen zurück
• Dateiinformationen abrufen
  • Erhalten Sie detaillierte Datei-/Verzeichnismetadaten
  • Eingabe: path (Zeichenfolge)
  • Widerrufsfolgen:
    • Größe
    • Erstellungszeit
    • Geänderte Zeit
    • Zugriffszeit
    • Typ (Datei/Verzeichnis)
    • Berechtigungen
• Liste zulässiger Verzeichnisse
  • Listet alle Verzeichnisse auf, auf die der Server zugreifen darf
  • Keine Eingabe erforderlich
  • Widerrufsfolgen:
    • Verzeichnisse, aus denen dieser Server lesen/schreiben kann

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

Hinweis: Sie können dem Server Sandbox-Verzeichnisse bereitstellen, indem Sie diese in /projects einbinden. Durch das Hinzufügen des Flags ro wird das Verzeichnis für den Server schreibgeschützt.

Docker

Hinweis: Alle Verzeichnisse müssen standardmäßig in /projects gemountet werden.

NPX

Verwendung mit VS Code

Klicken Sie für eine schnelle Installation auf die Installationsschaltflächen unten ...

Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open Settings (JSON) ein.

Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.

Beachten Sie, dass der mcp Schlüssel in der Datei .vscode/mcp.json nicht benötigt wird.

Sie können dem Server Sandbox-Verzeichnisse bereitstellen, indem Sie diese in /projects einbinden. Durch das Hinzufügen des Flags ro wird das Verzeichnis für den Server schreibgeschützt.

Docker

Hinweis: Alle Verzeichnisse müssen standardmäßig in /projects gemountet werden.

NPX

Bauen

Docker-Build:

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.