feat(mcp): initialisation serveur MCP taf-mcp espace Idees (perso-2026-10-218)
This commit is contained in:
commit
c3c9b0f06e
8 files changed
+423
No files matched your search
@@ -0,0 +1,30 @@
|
||||
# taf-mcp — Serveur MCP pour l'espace Idées de TAF
|
||||
|
||||
Serveur MCP exposant l'espace **Idées** de TAF (Ticket `perso-2026-10-218`) pour OpenClaw-Perso (NAS) et les autres assistants.
|
||||
|
||||
## Architecture
|
||||
|
||||
- **Protocole** : MCP via FastMCP et StreamableHTTP (`/mcp` et `/`).
|
||||
- **Réseau Docker** : `mcp-vps` (accès direct à l'API de TAF sur `http://taf:8000`).
|
||||
- **Ports d'écoute** : Publié **strictement** sur `127.0.0.1:3105` et `100.94.90.119:3105` (aucun accès 0.0.0.0 ni ::).
|
||||
- **Authentification** : Bearer token par assistant, validé en temps constant (`hmac.compare_digest`). Jeton OpenClaw-Perso transmis par la variable `TAF_MCP_TOKEN_OPENCLAW_PERSO`.
|
||||
- **Intégrité & Sécurité** :
|
||||
- Aucun montage de `docker.sock`.
|
||||
- Conteneur exécuté en utilisateur non-root (`appuser`, uid 1026).
|
||||
- Politique de redémarrage : `unless-stopped`.
|
||||
- Healthcheck HTTP sur `/health`.
|
||||
|
||||
## Les 6 Outils MCP
|
||||
|
||||
1. `idee_ajouter(texte, etiquettes)` : Ajoute une idée (force `space=idees`, `source=openclaw`, `status=nouvelle`).
|
||||
2. `idees_lister(statut, etiquette, depuis)` : Liste les idées actives selon les filtres.
|
||||
3. `idee_rechercher(mot)` : Recherche textuelle dans le texte brut, la reformulation et les étiquettes.
|
||||
4. `idee_recadrer(id, reformulation)` : Met à jour la reformulation (`reframed`). Toute tentative de modifier le texte brut original (`text` ou `texte`) est formellement rejetée (« le texte brut de Nabil est intouchable, utiliser idee_recadrer »).
|
||||
5. `idee_statut(id, statut)` : Modifie le statut (`nouvelle`, `a_creuser`, `en_cours`, `abandonnee`).
|
||||
6. `idee_etiqueter(id, etiquettes)` : Met à jour les étiquettes (maximum 8 étiquettes de 40 caractères).
|
||||
|
||||
## Règles Dures Imposées
|
||||
|
||||
- **Texte brut intouchable** : Aucun outil ne peut modifier le champ `text` d'une idée créée.
|
||||
- **Cloisonnement strict** : Tout accès à un identifiant appartenant à l'espace `taches` est rejeté.
|
||||
- **Aucune suppression** : Aucun outil de suppression n'est exposé.
|
||||
Reference in new issue
Block a user