Filesystem-Connector
Stellt ein oder mehrere Verzeichnisse als MCP-Ressourcen (filesystem://…) und Datei-Tools bereit. --path definiert den primären Root. Zusätzliche Verzeichnisse können mit --volume oder -v NAME=ABSOLUTE_PATH eingebunden werden. Der Zugriff bleibt auf diese Roots begrenzt; Pfade werden kanonisch aufgelöst und dürfen nicht aus den freigegebenen Wurzeln ausbrechen.
Flags
| Flag | Standard | Beschreibung |
|---|---|---|
--path | erforderlich oder Volume | Primäres Root-Verzeichnis für unpräfixierte Pfade. |
--volume / -v | Zusätzliches Verzeichnis im Format NAME=ABSOLUTE_PATH; mehrfach nutzbar. | |
--permission | read-only | Rechteprofil: read-only oder full. |
--tools | Kommagetrennte Allowlist, z. B. --tools read_file,list_directory. | |
--change-tracking-file | JSON-Datei für list_changes, um hinzugefügte, geänderte und gelöschte Dateien zu verfolgen. |
| Umgebungsvariable | Werte | Beschreibung |
|---|---|---|
AI_HUB_FS_RESOURCE_NOTIFICATIONS | 1/true, 0/false, leer | Erzwingt Resource-Notifications an oder aus. Leer folgt den Client-Capabilities. |
Verwendung
# Nur lesen
ai-hub-cli mcp ai-hub-cli filesystem-connector --path /pfad/zum/ordner
# Volle Rechte
ai-hub-cli mcp ai-hub-cli filesystem-connector \
--path /pfad/zum/ordner \
--permission full
# Mehrere Roots mit benannten Volumes
ai-hub-cli mcp ai-hub-cli filesystem-connector \
--path /projekt \
-v assets=/daten/assets \
-v export=/daten/export
# Nur ausgewählte Tools freigeben
ai-hub-cli mcp ai-hub-cli filesystem-connector \
--path /pfad/zum/ordner \
--tools search_files,read_file,list_directory
ai-hub-cli mcp ai-hub-cli filesystem-connector --path C:\Pfad\Zum\Ordner
MCP-Tools
| Tool | Parameter | Rechte | Zweck |
|---|---|---|---|
search_files | pattern, content, recursive, mime_type | Lesen | Dateien nach Name, Glob oder Inhalt suchen. |
read_file | path (Pflicht), base64 | Lesen | Dateiinhalt lesen; base64 gibt Binärdaten als Data-URL zurück. |
list_directory | path, recursive, include_hidden | Lesen | Verzeichnisinhalt listen; leer oder . listet den gemergten Top-Level. |
get_file_info | path (Pflicht) | Lesen | Metadaten für Datei oder Ordner lesen. |
glob_files | pattern, path, recursive, modified_since | Lesen | Dateien per Glob suchen, optional nur seit einem Zeitpunkt. |
write_file | path (Pflicht), content (Pflicht), base64, append | full | Datei schreiben oder anhängen. |
delete_file | path (Pflicht), recursive | full | Datei oder Ordner löschen. |
move_file | source (Pflicht), destination (Pflicht) | full | Datei oder Ordner verschieben/umbenennen. |
copy_file | source (Pflicht), destination (Pflicht), recursive | full | Datei oder Ordner kopieren. |
create_directory | path (Pflicht), parents | full | Ordner erstellen, optional mit Elternordnern. |
list_changes | pattern (Pflicht), last_modified (Pflicht) | Lesen | Hinzugefügte, geänderte und gelöschte Dateien seit einem Zeitpunkt melden. |
list_changes ist verfügbar, wenn --change-tracking-file gesetzt ist oder die Verbindung über AI Hub Hub-Storage (hub/storage) bereitstellt. last_modified akzeptiert RFC3339, z. B. 2026-06-26T12:00:00Z, oder Unix-Zeit in Sekunden.
Sicherheit
- Pfade werden kanonisch aufgelöst und müssen innerhalb der konfigurierten Roots liegen.
move_fileverschiebt nicht zwischen verschiedenen Roots; nutze dafür bewusst Kopieren und Löschen.- Bei Kollisionen zwischen Volume-Namen und Top-Level-Ordnern gewinnt das benannte Volume; Warnungen gehen nach stderr.
- Standard ist Least Privilege:
read-only, bis--permission fullexplizit gesetzt wird.