M

MCPVault

Un serveur MCP local pour rechercher et lire tes notes, puis autoriser explicitement certaines modifications.

Dépôt· Mauricio Wolff (bitbonsai)· Licence MITComment démarrer ↓

EN UN COUP D’ŒIL

Ça sert à
  • Retrouver des notes dans un périmètre
  • Lire ce qui soutient une réponse
  • Corriger un passage précis
Pour démarrer
  1. Préparer un vault
  2. Configurer en lecture seule
  3. Contrôler
  4. Autoriser une correction

C'est quoi ?

MCPVault relie un client IA compatible MCP à un dossier de notes obsidian. Le client lance un processus local en stdio, lui transmet une recherche ou un chemin de note, puis reçoit le résultat. Obsidian peut rester fermé : le serveur travaille directement sur les fichiers du vault, sans plugin.

Le projet, écrit par Mauricio Wolff (bitbonsai), est sous licence MIT ; son README documente plusieurs clients, dont claude-code et codex.

À quoi ça sert ?

Retrouver des notes dans un périmètre

search_notes reçoit une requête, se limite à un sous-dossier avec pathPrefix, en exclut avec excludePaths et borne les résultats avec limit. Il renvoie des chemins, des titres et des extraits classés.

Lire ce qui soutient une réponse

read_note fournit le corps et le frontmatter d'une note ; pour une note longue, get_note_outline donne les titres, puis read_note_lines lit une plage. Si deux notes ont le même titre, fais confirmer le chemin.

Corriger un passage précis

patch_note remplace un texte exact (oldString) par un autre (newString) ; avec replaceAll à false, il refuse une chaîne présente plusieurs fois. write_note crée ou remplace une note entière.

Pourquoi ?

Pour une question ponctuelle, la recherche Obsidian et un copier-coller suffisent. MCPVault devient utile quand l'assistant doit enchaîner plusieurs lectures, garder leurs chemins ou préparer une correction sur des fichiers existants.

Les limites tiennent aux droits et aux données. Un vault local ne rend pas le traitement local : si le client envoie les extraits à un modèle distant, ils quittent la machine. La recherche repose sur les mots présents (BM25) : elle ne prouve pas qu'un sujet est couvert, précise les synonymes. pathPrefix limite une recherche, pas la lecture d'un autre dossier : pour isoler un corpus, expose une copie. Le mode --read-only retire les outils de modification et rejette leurs appels, ce qu'une consigne « ne modifie rien » ne garantit pas. Sans lui, le serveur peut modifier et supprimer des notes : relis après écriture et garde une copie restaurable.

Comment je m'en sers ?

  1. Préparer un vault

    Il faut Node.js 20 ou plus et un client MCP local en stdio. Pars d'un vault de démonstration, sauvegardé.

  2. Configurer en lecture seule

    Dans la configuration MCP du client, lance le paquet avec le chemin du vault, toujours indiqué (sans lui, le serveur prend le dossier courant), et l'option --read-only.

    npx @bitbonsai/mcpvault@latest /chemin/du/vault --read-only
  3. Contrôler

    Recharge le client : les outils de modification doivent être absents. Fais une recherche, puis lis un résultat par son chemin exact.

  4. Autoriser une correction

    Sur la copie seulement, retire --read-only, recharge, puis fais lire la note avant de demander patch_note avec le texte exact et replaceAll à false. Relis ensuite le corps et le frontmatter.

Recevoir la newsletter

Des tutos, des essais et des retours bruts sur ce que je construis. Le lien pour te désabonner est en bas de chaque édition.

L’inscription se termine sur Substack, dans un nouvel onglet.