vault-cortex

Vault Cortex est un serveur MCP (Model Context Protocol) autonome qui fournit aux agents IA une recherche hybride, la gestion des tâches, une mémoire structurée et un accès lecture/écriture aux coffres Obsidian. Il agit directement sur les fichiers `.md` sur disque, sans nécessiter d’extension Obsidian ni d’instance ouverte. Le serveur s’exécute dans un seul conteneur Docker et peut être déployé localement, auto-hébergé sur un VPS, ou via un déploiement en un clic sur Railway ou Render pour un accès à distance. **Fonctionnalités clés :** - **Recherche hybride** : associe la correspondance de mots-clés FTS5 et la similarité sémantique vectorielle via Reciprocal Rank Fusion (RRF), puis affine les requêtes à forte intention par un réordonnancement cross-encoder. Tous les modèles s’exécutent localement (~45 Mo au total, aucune API externe). - **Mémoire structurée** : système d’entrées datées et en ajout seul, stocké dans de simples fichiers Markdown (dossier `About Me/` par défaut). Le rappel thématique récupère les entrées pertinentes dans tous les fichiers de mémoire, en montrant l’état actuel et l’évolution historique. Prend en charge `entry-policy: living` pour les entrées d’état actuel pouvant être élaguées. - **Gestion des tâches** : requêtes et mises à jour de tâches compatibles avec Kanban. Prend en charge le filtrage par statut, dates, priorité, dossier ou colonne. Gère à la fois les signifiants emoji du plugin Tasks et les formats de champs inline Dataview. Terminer des tâches récurrentes crée les occurrences suivantes ; prend en charge les actions « On completion ». - **Accès aux fichiers** : lit les fichiers non Markdown, y compris les images (réduites côté serveur), les PDF (extraction de texte ou pages rendues), les fichiers Canvas (plans lisibles) et les fichiers de données (TXT, SVG, JSON, XML, CSV, YAML, logs, Bases). - **Graphe de liens** : rétroliens, liens sortants et détection des fichiers orphelins dans tout le coffre. - **Natif Obsidian** : comprend les frontmatter, liens wiki, étiquettes, titres et notes quotidiennes. - **Workflows guidés** : invites intégrées pour la santé du coffre, la revue de mémoire et la réconciliation quotidienne, assemblées à partir des données en temps réel du coffre. **Authentification** : prend en charge OAuth 2.1 pour l’accès à distance avec pages de consentement, ainsi qu’un jeton Bearer pour les clients sans OAuth. Le renouvellement des jetons est géré automatiquement pour les clients OAuth. **Options de déploiement** : - Local : Docker + dossier du coffre, configuration via `npx vault-cortex@latest init` - À distance : déploiement en un clic sur Railway ou Render, ou auto-hébergement sur n’importe quel VPS Linux avec Docker - Les déploiements à distance utilisent Obsidian Sync pour maintenir le coffre à jour sur tous les appareils **Configuration** : l’interface CLI gère le cycle de vie du serveur (`configure`, `upgrade`, `start`, `restart`, `logs`, `down`). Une configuration manuelle Docker Compose est également disponible. Une page de configuration à `/setup` gère la connexion à Obsidian Sync pour les déploiements à distance. **Sécurité** : inclut une intégration continue avec analyses Gitleaks et Trivy, ainsi que les badges OpenSSF Scorecard et Best Practices. Le coffre reste la source de vérité en Markdown brut ; le conteneur n’en conserve qu’une copie. **Cas d’usage** : testé pendant un voyage de 15 jours en Europe, avec plus de 30 sessions depuis un téléphone, 216 appels d’outils et aucun accès à un ordinateur portable. Les écritures d’une session étaient immédiatement disponibles dans la suivante, à travers les villes et les jours.