vault-mcp

Serveur MCP unifié du vault Obsidian : lecture, recherche sémantique (hybride), graphe et écriture soumise à consentement. Pensé pour exposer un vault de connaissances à des agents IA (Claude, Codex, ChatGPT…) derrière une passerelle d'authentification.

Version courante : 2.0.0 (pyproject.toml).

Fonctionnalités

• Lecture / recherche lexicale + vectorielle (moteur hybride par fusion à rang réciproque).

• Graphe de notes (backlinks, liens sortants, liens non résolus).

• Écriture par lots d'intentions : consentement, détection de conflits, spool.

• Serveur MCP streamable-http + serveur HTTP séparé (server_http.py historique, non inclus).

Structure

vault_mcp/          paquet principal (serveur, store, index, chunk, spool, auth, oauth…)
scripts/            utilitaires d'exploitation (reindex, parité)
tests/              suites pytest (+ jeu de requêtes de référence queries.json)
pyproject.toml      métadonnées + config ruff (bandit activé) et mypy strict

Exécution

pip install -r requirements.txt
python -m vault_mcp.server          # service MCP (variables via l'environnement)
pytest                              # tests

Variables d'environnement : voir .env.example (aucune valeur réelle n'est versionnée — le fichier d'env du service vit hors Git, en 0600).

Déploiement

Service systemd dédié (User=<compte de service>, ProtectSystem=strict, PrivateTmp=yes…), alimenté par un miroir CouchDB du vault ; l'écriture remonte par spool vers l'instance de référence. Voir scripts/reindex.py (reconstruction de l'index) et scripts/parite.py (vérification de parité miroir ↔ source).