67f33fc81e6a582608b1cb466e2469f7b655af2e
notebook-mcp : Passerelle MCP pour Open Notebook cloisonnée par sphère
Passerelle MCP imposant le cloisonnement strict par sphère (tt, nyora, perso, infra, test-a, test-b) devant l'instance Open Notebook locale sur le VPS (Ticket infra-2026-10-042).
Objectifs & Sécurité
- Cloisonnement strict par sphère : Aucun carnet ni document d'une sphère ne peut être vu, interrogé ou recherché depuis une autre sphère.
- Double vérification : Vérification des autorisations en amont (registre SQLite interne
./state/registry.db) et filtrage strict a posteriori des sources citées dans les réponses ou résultats. - Invisibilité des carnets hors registre : Les carnets créés en direct dans Open Notebook sans passer par la passerelle sont strictement invisibles et inaccessibles aux assistants.
- Erreurs uniformes : Un identifiant de carnet inconnu et un identifiant de carnet d'une autre sphère renvoient exactement le même message d'erreur au caractère près (
Carnet introuvable : <id>), empêchant toute déduction d'existence. - Transport : Streamable HTTP sur
/mcp/et endpoint/healthpour le monitoring. - Authentification : Jeton Bearer par assistant, vérifié par empreinte sha256 dans
tokens/tokens.json. - Limitation de débit : 60 requêtes par minute par identité au total, dont 10 pour
notebook_ask. Les appels refusés comptent dans la limite. - Journalisation sans secret : Chaque appel est tracé dans
/app/logs/access.log(date, identité, outil, id de carnet, statut, durée). Aucun mot de passe, jeton, texte de question ou de réponse n'est journalisé. - Conteneur durci : Utilisateur non-root (
appuser), limite mémoire de 256 Mo, ports 3104 liés uniquement à127.0.0.1et100.94.90.119.
Outils MCP exposés (6 outils)
notebook_list(): Liste les carnets visibles par l'appelant selon ses sphères autorisées.notebook_create(sphere, name, description=""): Crée le carnet dans Open Notebook et l'inscrit dans le registre de la passerelle.source_add_text(notebook_id, title, content): Ajoute une source textuelle dans un carnet existant (vectorisation automatique, limité à 200 000 caractères).source_list(notebook_id): Liste les sources du carnet (id,title,embedded).notebook_ask(notebook_id, question): Réponse sourcée par Open Notebook, filtrée et vérifiée.notebook_search(query, notebook_id="", max_results=8): Recherche compacte cloisonnée aux carnets autorisés.
Gestion des jetons
Le script mint-token.sh <identité> <fichier-sortie> permet de générer un jeton de 48 caractères hexadécimaux et d'inscrire son empreinte sha256 dans tokens/tokens.json.
Le jeton est écrit avec permissions 0600 et n'est jamais affiché dans les terminaux ou journaux.
Languages
Python
95.6%
Shell
3%
Dockerfile
1.4%