Obsidian Scoped-write MCP

MCP-Dienst für den Zugriff auf einen bestimmten Obsidian-Vault. Der gesamte Vault ist lesbar; das Erstellen und Aktualisieren von Markdown ist nur in zwei ChatGPT-spezifischen Verzeichnissen erlaubt:

• 00-ChatGPT系统入口

• 01-ChatGPT策略主脑

Es werden keine Werkzeuge zum Löschen, Verschieben, Umbenennen oder zum Schreiben von Nicht-Markdown-Dateien bereitgestellt.

Werkzeuge

• list_directory: Verzeichnis auflisten.

• read_markdown: Markdown lesen.

• search_markdown: Markdown durchsuchen.

• get_file_info: Größe, Änderungszeit, SHA-256 und Schreibstatus anzeigen.

• create_directory: Erstellt einen einfachen Unterordner der ersten Ebene innerhalb eines erlaubten Verzeichnisses; das übergeordnete Verzeichnis muss bereits vorhanden sein.

• create_markdown: Erstellt eine neue Datei in einem erlaubten Verzeichnis; Überschreiben ist verboten.

• update_markdown: Aktualisiert eine vorhandene Datei mit erwarteter SHA-256-Prüfung und erstellt vor der Aktualisierung eine Sicherung außerhalb des Vaults.

Related MCP server: Obsidian MCP Local

Lokale Verifizierung

npm ci
npm test

Der Test erstellt standardmäßig einen temporären Vault und ein temporäres Sicherungsverzeichnis und berührt keine persönlichen Obsidian-Daten. Wenn ein echter Vault-Pfad übergeben wird, werden nur Lesetests ausgeführt, keine Schreibvorgänge.

Sicherheitsgrenzen

• Die Schreibverzeichnisse werden durch eine serverseitige feste Whitelist gesteuert; Tool-Parameter können den Umfang nicht erweitern.

• Das Erstellen von Ordnern ist nur auf der ersten Ebene erlaubt; gleichnamige Verzeichnisse, versteckte Verzeichnisse, fehlende übergeordnete Verzeichnisse, Pfade außerhalb des Bereichs und Symlink-Escapes werden abgelehnt.

• Wenn das Erstellungsziel bereits existiert, wird abgelehnt.

• Vor der Aktualisierung wird zuerst get_file_info aufgerufen, und die zurückgegebene sha256 wird als expected_sha256 verwendet; wenn sich die Datei geändert hat, wird die Aktualisierung abgelehnt.

• Vor der Aktualisierung wird eine Sicherung im lokalen Anwendungsdatenverzeichnis des aktuellen Windows-Benutzers erstellt; die Sicherung befindet sich nicht im Vault und nicht im Git-Repository.

• Absolute Pfade, Pfade außerhalb des Bereichs, Symlink-Escapes und Nicht-Markdown-Dateien werden abgelehnt.

Entwicklungsablauf

• main bleibt jederzeit veröffentlichbar.

• Alle Repository-Änderungen nutzen kurzlebige Branches und Pull Requests.

• Die Zusammenführung erfolgt erst nach bestandener CI, standardmäßig mit Squash-Merge.

• Für Architektur, Sicherheitsgrenzen, Datenformate, erweiterte Abhängigkeiten oder große Funktionen mit mehreren unabhängigen PRs: übergeordnetes Issue, Sub-Issues, ADR, PR, CI und Rollback-Aufzeichnung.

• Kleine Patches: einzelnes Issue oder PR, minimale Änderungen, minimale Tests und Rollback-Hinweise.

Abnahme für leichte Patches

• Abnahme: npm test ausführen und nach erfolgreicher CI-Prüfung des Pull Requests zusammenführen.

• Rollback: Den entsprechenden Squash-Commit auf GitHub wiederherstellen.