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.

Related MCP server: Readonly Filesystem MCP Server

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.