Dateisystem-MCP-Server

Node.js-Server, der Model Context Protocol (MCP) für Dateisystemoperationen implementiert.

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.

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/filesystem",
        "/projects"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

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.

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--mount", "type=bind,src=${workspaceFolder},dst=/projects/workspace",
          "mcp/filesystem",
          "/projects"
        ]
      }
    }
  }
}

NPX

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "${workspaceFolder}"
        ]
      }
    }
  }
}

Bauen

Docker-Build:

docker build -t mcp/filesystem -f src/filesystem/Dockerfile .

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.

Filesystem MCP Server

Integrations