Files
taf-mcp/README.md
T

1.9 KiB

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é.