mcp-server-filesystem

MCP-Server, der Linux-Dateisystemoperationen als Werkzeuge für LLM-Agenten bereitstellt, erstellt mit FastMCP. Entwickelt als ein leichtgewichtiger, abhängigkeitsarmer Testserver für das mcprack MCP-Proxy-/Katalog-Tool.

Konfiguration

Es sind keine Anmeldedaten erforderlich. Die gesamte Konfiguration erfolgt über Umgebungsvariablen, die beim Start einmal gelesen werden:

Alle an Werkzeuge übergebenen Pfade werden gegen FS_ROOT aufgelöst und abgelehnt, wenn sie es (über .. oder einen Symlink) verlassen würden. Dies ist eine Grenze auf Anwendungsebene, keine gehärtete Sandbox (kein chroot/Mount-Namespace).

Related MCP server: ab_mcp

Werkzeuge

Nur lesend: list_dir, read_file, stat, exists, glob_search.

Verändernd (erfordert FS_READONLY=false): write_file, mkdir, delete, move, copy.

Verwendung

Empfohlen — Debian-Paket aus dem VitexSoftware-Repository

sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/vitexsoftware-archive-keyring.gpg] http://repo.vitexsoftware.com trixie main backports" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update
sudo apt install mcp-server-filesystem

Die Komponente backports ist erforderlich, nicht optional: python3-mcp (eine Abhängigkeit von python3-fastmcp) benötigt python3-jsonschema >= 4.20.0, das neuer ist als die Version, die Debian trixie in main ausliefert — es ist nur in backports verfügbar. Ohne sie schlägt apt install mit einem Fehler wegen nicht erfüllter Abhängigkeiten in Bezug auf python3-jsonschema fehl.

Dies installiert python3-fastmcp und mcp-server-filesystem in einem einzigen Schritt.

Alternative — pip

pip install -e .
export FS_ROOT=/path/to/sandbox
mcp-server-filesystem

mcprack-Integration

Registrieren Sie diesen Server in mcprack mit:

• Befehl: mcp-server-filesystem

• Umgebung: FS_ROOT=/path/to/sandbox, FS_READONLY=false (falls Schreibzugriff benötigt wird)

mcprack startet ihn als Stdio-Unterprozess und proxyt ihn pro Benutzer über HTTP.

Entwicklung

pytest