Obsidian MCP Local

MCP lokal in Node.js + TypeScript, um Ihren Obsidian-Vault für VS Code + GitHub Copilot verfügbar zu machen.

Es wurde für die lokale Nutzung via stdio entwickelt, mit Fokus auf das Lesen und Schreiben von Markdown-Notizen innerhalb Ihres Vaults.

Features

Verfügbare Tools

• search_notes(query)

  • sucht nach Text im Pfad, Frontmatter und Inhalt der Notizen

  • gibt gerankte Ergebnisse mit einem kurzen Auszug zurück

• get_note(path)

  • öffnet eine Notiz aus dem Vault

  • gibt path, frontmatter und content zurück

• create_note(path, content, overwrite?)

  • erstellt eine neue Notiz

  • überschreibt optional eine bestehende Notiz

• append_to_note(path, content)

  • fügt Inhalt am Ende einer bestehenden Notiz hinzu

• find_by_tag(tag)

  • findet Notizen nach Tag

  • unterstützt tags im Frontmatter und Inline-Tags im Inhalt

Implementierte Regeln

• greift nur auf Dateien innerhalb des konfigurierten Vaults zu

• ignoriert Verzeichnisse wie:

  • .obsidian

  • .git

  • node_modules

• arbeitet nur mit .md-Dateien

• normalisiert Pfade, um Zugriffe außerhalb des Basisverzeichnisses zu verhindern

Projektstruktur

obsidian-mcp-local/
  package.json
  tsconfig.json
  README.md
  .vscode/
    mcp.example.json
  src/
    index.ts

Voraussetzungen

• Node.js 20+

• npm

• VS Code mit GitHub Copilot

• ein lokaler Obsidian-Vault

Installation

Im Projektverzeichnis:

npm install
npm run build

Für die Entwicklung:

npm run dev

Um die kompilierte Version auszuführen:

npm start

Verwendung in VS Code

1. Projekt kompilieren

npm install
npm run build

2. VS Code MCP-Datei anpassen

Kopieren Sie den Inhalt von .vscode/mcp.example.json in Ihre .vscode/mcp.json im Workspace, in dem Sie Copilot verwenden möchten.

Beispiel:

{
  "servers": {
    "obsidian-local-vault": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

3. Pfade aktualisieren

Ersetzen Sie:

• C:/caminho/para/obsidian-mcp-local/dist/index.js

• D:/Obsidian/Vault

durch die tatsächlichen Pfade auf Ihrem Rechner.

4. VS Code neu starten/neu laden

Danach sollte Copilot den MCP-Server erkennen.

Anwendungsbeispiele im Copilot Chat

• „Suche in meinem Vault nach Notizen über .NET“

• „Öffne die Notiz knowledge/backend/dotnet.md“

• „Erstelle eine Notiz in inbox/ideias-mcp.md mit einer Zusammenfassung dessen, was wir besprochen haben“

• „Füge am Ende der Notiz daily/2026-04-06.md den Text - testar MCP local hinzu“

• „Finde Notizen mit dem Tag #arquitetura“

Mögliche zukünftige Verbesserungen

• append_under_heading

• Parsing von [[wikilinks]]

• get_backlinks(note)

• SQLite-Index für schnelle Suche

• Whitelist von Ordnern für Schreibzugriffe (inbox/, daily/, scratch/)

• Konfigurierbare Schreibsperre für bestimmte Ordner

Wichtige Hinweise

• Dieses Projekt hängt nicht davon ab, dass Obsidian geöffnet ist.

• Es arbeitet direkt auf den Dateien des Vaults.

• Wenn Sie Schreibzugriffe sowohl in Obsidian als auch in VS Code aktivieren, liegt die Kontrolle über die Nebenläufigkeit bei Ihnen.

• Das Projekt geht derzeit davon aus, dass der Vault ein lokaler Markdown-Ordner ist.

Hauptdatei

Die Implementierung befindet sich in:

• src/index.ts

Lizenz

Persönliche Nutzung / Basis für Anpassungen.