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