Sicherheitsmodell

Wie VaultTools MCP Ihre Dateien schützt: Sandboxing, Isolation und vorhersagbare Verarbeitung.

Verzeichnis-Sandboxing

Jede Dateioperation wird vor der Ausführung gegen die --allowed-dir-Liste geprüft. Pfade werden in ihre absolute Form kanonisiert, um Traversal-Angriffe über ../ oder Symlinks zu verhindern. Wenn ein aufgelöster Pfad außerhalb aller erlaubten Verzeichnisse liegt, wird die Operation mit einem ACCESS_DENIED-Fehler abgelehnt.

Sie können mehrere erlaubte Verzeichnisse angeben, indem Sie das Flag wiederholen: --allowed-dir ~/Documents --allowed-dir ~/Pictures. Der Server startet nicht ohne mindestens ein erlaubtes Verzeichnis.

Ausgabe-Isolation

Wenn --output-dir gesetzt ist, werden alle Ausgabedateien in dieses Verzeichnis geschrieben statt neben die Eingabedateien. Dies trennt verarbeitete Ergebnisse von Originaldateien.

Ausgabedateien überschreiben niemals bestehende Dateien. Der Server hängt ein numerisches Suffix an (-1, -2, etc.), um Kollisionen zu vermeiden. Wiederholte Tool-Aufrufe sind somit immer sicher. Sie erstellen neue Dateien, anstatt bestehende Daten zu zerstören.

Fehler-Bereinigung

Fehlermeldungen, die an das KI-Modell zurückgegeben werden, werden auf 500 Zeichen gekürzt. Dies verhindert versehentliche Weitergabe von Dateiinhalten durch ausführliche Fehlermeldungen (z. B. ein JSON-Parse-Fehler, der einen Ausschnitt der Datei enthält).

Fehler enthalten genug Information, damit die KI es erneut versuchen oder das Problem melden kann, beinhalten aber niemals rohe Dateidaten.

Zustandslose Verarbeitung

Jeder Tool-Aufruf ist völlig unabhängig. Der Server speichert keinen Zustand zwischen Aufrufen: keine Caches, keine Sitzungsdaten, keine temporären Dateien. Jede Ausführung liest von der Festplatte, verarbeitet im Speicher und schreibt zurück auf die Festplatte.

Tool-Aufrufe sind somit idempotent: Der gleiche Aufruf mit den gleichen Eingaben erzeugt immer die gleiche Ausgabe (abgesehen von Kollisionsvermeidungs-Suffixen bei Ausgabedateinamen).

Keine Telemetrie

Der Server macht keine Netzwerkanfragen. Es gibt keine Analytics, keine Absturzberichte, keine Update-Prüfungen und kein Phone-Home-Verhalten. Kommunikation erfolgt ausschließlich über stdio (stdin/stdout) mit dem MCP-Client.

Logs werden auf stderr geschrieben (nicht stdout, das für MCP JSON-RPC reserviert ist) und sind standardmäßig deaktiviert. Aktivieren Sie sie mit --verbose zum Debuggen.

Hash-Verifizierung

Die Tools vaulttools_file_checksum und vaulttools_dev_hash ermöglichen die Verifizierung der Ausgabe-Integrität. Nach jeder Dateitransformation berechnen Sie eine Prüfsumme der Ausgabe, um zu bestätigen, dass sie den Erwartungen entspricht.

Verfügbare Algorithmen: MD5, SHA-1, SHA-256, SHA-512. Prüfsummen werden lokal berechnet und als Metadaten zurückgegeben. Der Dateiinhalt wird niemals in die Antwort einbezogen.

Pfad-basierte E/A

Dies ist das grundlegende Designprinzip. Der KI-Agent sendet Dateipfade als Eingabe. Der Server liest die Dateien, verarbeitet sie, schreibt die Ausgabe und gibt nur Metadaten zurück (Ausgabepfad, Dateigröße, Dimensionen, Prüfsummen, etc.).

Datei-Bytes erscheinen nie in der MCP-Antwort. Ihre Dateien gelangen nicht in das Kontextfenster des KI-Modells, werden an keine Remote-API gesendet und sind nicht im Konversationsverlauf enthalten.