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 /health pour 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.1 et 100.94.90.119.

Outils MCP exposés (6 outils)

  1. notebook_list() : Liste les carnets visibles par l'appelant selon ses sphères autorisées.
  2. notebook_create(sphere, name, description="") : Crée le carnet dans Open Notebook et l'inscrit dans le registre de la passerelle.
  3. source_add_text(notebook_id, title, content) : Ajoute une source textuelle dans un carnet existant (vectorisation automatique, limité à 200 000 caractères).
  4. source_list(notebook_id) : Liste les sources du carnet (id, title, embedded).
  5. notebook_ask(notebook_id, question) : Réponse sourcée par Open Notebook, filtrée et vérifiée.
  6. 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.

S
Description
No description provided
Readme
78 KiB
0 Stars 1 Watchers 0 Forks
Languages
Python 95.6%
Shell 3%
Dockerfile 1.4%