Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/r2d2helm/knowledge-assistant-mcp
cd knowledge-assistant-mcpThen follow the repository README for any remaining dependency or build steps.
2
Register it in Claude Code
claude mcp add -e "KNOWLEDGE_VAULT_PATH=${KNOWLEDGE_VAULT_PATH}" -e "KNOWLEDGE_INDEX_PATH=${KNOWLEDGE_INDEX_PATH}" knowledge-assistant -- uv run --directory /path/to/knowledge-assistant-mcp python -m src.serverReplace any placeholder paths in the command with the real path on your machine.
Required:
KNOWLEDGE_VAULT_PATHKNOWLEDGE_INDEX_PATH+ 1 optional3
Make your agent remember this setup
knowledge-assistant's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Multi-term search with AND logic for precise note retrieval
- Direct reading of note content within the Claude interface
- Relationship discovery through related notes and backlink analysis
- Vault statistics and tag-based exploration
- Tracking of recently modified notes
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.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.
Original README from r2d2helm/knowledge-assistant-mcp
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\
otes-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 |
| otes-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