feat(mcp): passerelle MCP notebook-mcp pour Open Notebook cloisonné par sphère (infra-2026-10-042)
This commit is contained in:
commit
cc20ccef2f
9 files changed
+1110
No files matched your search
@@ -0,0 +1,26 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user