# treblo-mcp — Serveur MCP pour le service de musique Treblo Serveur MCP exposant le service de musique Treblo (Ticket `nyora-2026-10-216`) pour Hermes-nyora et OpenClaw-Perso. ## Architecture - **Protocole** : MCP via FastMCP et StreamableHTTP (`/mcp` et `/`). - **Réseau Docker** : `mcp-vps`. - **Ports d'écoute** : Publié **strictement** sur `127.0.0.1:3106` et `100.94.90.119:3106` (aucun accès 0.0.0.0 ni ::). - **Authentification** : Bearer token par sphère, validé en temps constant (`hmac.compare_digest`). Jeton Nyora via `TREBLO_MCP_TOKEN_NYORA` et jeton Perso via `TREBLO_MCP_TOKEN_PERSO`. - **Intégrité & Sécurité** : - Aucun montage de `docker.sock`. - Conteneur exécuté en utilisateur non-root (`appuser`, uid 1005). - Politique de redémarrage : `unless-stopped`. - Healthcheck HTTP sur `/health`. ## Les 4 Outils MCP 1. `generer(sphere, tags, paroles, prompt)` : Déclenche une génération musicale. Refuse si tags + paroles + prompt sont fournis ensemble, si plus de 64 tags, ou si le plafond journalier est atteint. 2. `statut(task_id)` : Consulte l'état d'avancement d'une tâche de génération auprès de Treblo. 3. `recuperer(task_id, sphere)` : Télécharge les fichiers générés (FLAC ou WAV pour l'archive, MP3 pour l'écoute) dans `musique//` avec le fichier JSON de métadonnées associé. 4. `solde(sphere)` : Consulte le solde des crédits Treblo (abonnements et paiements à l'usage). ## Garde-fous et Règles Dures - **Plafond quotidien** : Contrôle du nombre de générations par sphère via la variable d'environnement `TREBLO_DAILY_CAP` (défaut 5). Script `/app/cap_check.py ` disponible pour contrôle hors-ligne. - **Validation stricte** : Refus d'avoir tags, paroles et prompt en même temps. Refus si plus de 64 étiquettes. - **Cloisonnement des sphères** : Le jeton Nyora ne peut interagir qu'avec la sphère nyora, et le jeton Perso qu'avec la sphère perso. - **Journalisation sécurisée** : Les requêtes acceptées sont tracées dans `data/journal.jsonl` avec empreinte SHA-256 du prompt/paroles, sans jamais enregistrer de clé ni de jeton.