Allows for querying and interacting with an Obsidian vault, providing tools to search notes using AND logic, read content, find related notes, explore tags, and track backlinks and recent modifications.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Knowledge Assistant MCP Serversearch my vault for notes about PowerShell and UTF-8"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Knowledge Assistant MCP Server
Serveur MCP (Model Context Protocol) pour interroger un vault Obsidian depuis Claude Code.
Fonctionnalités
Outil | Description |
| Recherche multi-termes avec logique AND |
| Lire le contenu complet d'une note |
| Trouver les notes liées à un concept |
| Statistiques du vault (notes, tags, types) |
| Lister les notes par tag |
| Trouver les backlinks d'une note |
| 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 |
| Chemin du vault Obsidian |
|
|
| Chemin du fichier d'index |
|
|
| Durée du cache en secondes |
|
|
Structure du Vault
Knowledge/
├── _Inbox/ # Nouvelles captures
├── Concepts/ # Notes atomiques (C_*)
├── Conversations/ # Sessions Claude
├── Projets/ # Notes projet
├── Références/ # Documentation
└── ...Licence
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.