Obsidian MCP Local
Obsidian MCP Local
Lokaler MCP in Node.js + TypeScript, um Ihren Obsidian-Vault für VS Code + GitHub Copilot verfügbar zu machen.
Er wurde für die lokale Nutzung via stdio entwickelt, mit Fokus auf das Lesen und Schreiben von Markdown-Notizen innerhalb Ihres Vaults.
Install
npm install -g obsidian-mcp-local
Related MCP server: Obsidian MCP Server
Features
Verfügbare Tools
search_notes(query)sucht nach Text im Pfad, Frontmatter und Inhalt der Notizen
gibt gerankte Ergebnisse mit einem kurzen Ausschnitt zurück
get_note(path)öffnet eine Notiz aus dem Vault
gibt
path,frontmatterundcontentzurü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
tagsim Frontmatter und Inline-Tags im Inhalt
Implementierte Regeln
greift nur auf Dateien innerhalb des konfigurierten Vaults zu
ignoriert Verzeichnisse wie:
.obsidian.gitnode_modules
arbeitet nur mit
.md-Dateiennormalisiert 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.tsVoraussetzungen
Node.js 20+
npm
VS Code mit GitHub Copilot
ein lokaler Obsidian-Vault
Installation
Im Projektverzeichnis:
npm install
npm run buildFür die Entwicklung:
npm run devUm die kompilierte Version auszuführen:
npm startVerwendung in VS Code
1. Projekt kompilieren
npm install
npm run build2. MCP-Datei von VS Code 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: bei lokaler Nutzung:
{
"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"
}
}
}
}bei Nutzung via npx (kein lokaler Build erforderlich):
{
"servers": {
"obsidian-local-vault": {
"command": "npx",
"args": ["-y", "obsidian-mcp-local"],
"env": {
"OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
}
}
}
}3. Pfade aktualisieren
Ersetzen Sie:
C:/caminho/para/obsidian-mcp-local/dist/index.jsD:/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.mdmit einer Zusammenfassung dessen, was wir besprochen haben“„Füge am Ende der Notiz
daily/2026-04-06.mdden Text- testar MCP localhinzu“„Finde Notizen mit dem Tag
#arquitetura“
Mögliche zukünftige Verbesserungen
append_under_headingParsing 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.
Available Tools
5 toolsappend_to_noteD
Inputs: path (required), content (required).
create_noteD
Inputs: path (required), content (required), overwrite.
find_by_tagD
Inputs: tag (required).
get_noteD
Inputs: path (required).
search_notesD
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool name clearly indicates a distinct operation: create, get, append, search, and find by tag. No significant overlap is apparent.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_note, search_notes), making the set predictable.
Five tools cover essential note operations (create, retrieve, modify, search, tag) without unnecessary bloat or deficiency for the domain.
The set includes create, read, update (via append), and search operations but lacks a delete operation, which is a notable gap for a complete CRUD surface.
Maintenance
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables direct file system access to Obsidian vaults with auto-discovery, full-text search, and note operations. Supports reading, writing, and searching across Obsidian notes without requiring plugins or REST API.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Obsidian vaults through direct filesystem access, supporting note management, lightning-fast search with SQLite indexing, image analysis, tag/link management, and bulk operations.MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.3,713 npm-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with local Obsidian vaults through direct filesystem access for reading, creating, and managing notes. It features high-performance SQLite indexing for fast searches, regex support, and tools for organizing tags and links without requiring additional plugins.271MIT