README.md
Interact with Obsidian vaults through Claude Code
Knowledge Assistant MCP Server
Serveur MCP (Model Context Protocol) pour interroger un vault Obsidian depuis Claude Code.
Fonctionnalités
| Outil | Description |
|---|---|
knowledge_search |
Recherche multi-termes avec logique AND |
knowledge_read |
Lire le contenu complet d'une note |
knowledge_related |
Trouver les notes liées à un concept |
knowledge_stats |
Statistiques du vault (notes, tags, types) |
knowledge_explore_tag |
Lister les notes par tag |
knowledge_backlinks |
Trouver les backlinks d'une note |
knowledge_recent |
Notes récemment modifiées |
Installation
Prérequis
- Python 3.10+
- uv (gestionnaire de packages)
Configuration Claude Code
Linux/macOS
Ajouter dans ~/.claude/settings.json :
{
"mcpServers": {
"knowledge-assistant": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/knowledge-assistant-mcp",
"python",
"-m",
"src.server"
],
"env": {
"KNOWLEDGE_VAULT_PATH": "/home/username/Documents/Knowledge",
"KNOWLEDGE_INDEX_PATH": "/home/username/.knowledge/notes-index.json"
}
}
}
}
Windows
{
"mcpServers": {
"knowledge-assistant": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--directory",
"C:\\path\\to\\knowledge-assistant-mcp",
"python",
"-m",
"src.server"
],
"env": {
"KNOWLEDGE_VAULT_PATH": "C:\\Users\\username\\Documents\\Knowledge",
"KNOWLEDGE_INDEX_PATH": "C:\\Users\\username\\.knowledge\\notes-index.json"
}
}
}
}
Utilisation
Recherche multi-termes
knowledge_search("PowerShell UTF-8")
→ Trouve les notes contenant tous les termes (AND)
Lire une note
knowledge_read("Concepts/C_Zettelkasten.md")
Notes liées
knowledge_related("PowerShell")
Explorer un tag
knowledge_explore_tag("dev/powershell")
Configuration
Les chemins sont configurables via variables d'environnement :
| Variable | Description | Défaut Linux/macOS | Défaut Windows |
|---|---|---|---|
KNOWLEDGE_VAULT_PATH |
Chemin du vault Obsidian | ~/Documents/Knowledge |
%USERPROFILE%\Documents\Knowledge |
KNOWLEDGE_INDEX_PATH |
Chemin du fichier d'index | ~/.knowledge/notes-index.json |
%USERPROFILE%\.knowledge\notes-index.json |
KNOWLEDGE_CACHE_TTL |
Durée du cache en secondes | 60 |
60 |
Structure du Vault
Knowledge/
├── _Inbox/ # Nouvelles captures
├── Concepts/ # Notes atomiques (C_*)
├── Conversations/ # Sessions Claude
├── Projets/ # Notes projet
├── Références/ # Documentation
└── ...
Licence
MIT
Tools (7)
knowledge_searchPerforms multi-term searching with AND logic.knowledge_readReads the full content of a specific note.knowledge_relatedFinds notes related to a specific concept.knowledge_statsProvides statistics about the vault including notes, tags, and types.knowledge_explore_tagLists all notes associated with a specific tag.knowledge_backlinksFinds all backlinks for a given note.knowledge_recentLists notes that were recently modified.Environment Variables
KNOWLEDGE_VAULT_PATHrequiredThe file system path to the Obsidian vault.KNOWLEDGE_INDEX_PATHrequiredThe file system path to the notes index JSON file.KNOWLEDGE_CACHE_TTLThe duration of the cache in seconds.Configuration
claude_desktop_config.json
{"mcpServers": {"knowledge-assistant": {"type": "stdio", "command": "uv", "args": ["run", "--directory", "/path/to/knowledge-assistant-mcp", "python", "-m", "src.server"], "env": {"KNOWLEDGE_VAULT_PATH": "/home/username/Documents/Knowledge", "KNOWLEDGE_INDEX_PATH": "/home/username/.knowledge/notes-index.json"}}}}Try it
→Search my vault for notes containing both 'PowerShell' and 'UTF-8'.
→Read the content of the note located at 'Concepts/C_Zettelkasten.md'.
→Find all notes related to the concept of 'PowerShell'.
→List all notes that are tagged with 'dev/powershell'.
→Show me the backlinks for my 'Project Alpha' note.