feat(mcp): initialisation serveur MCP Treblo musique (nyora-2026-10-216)
This commit is contained in:
commit
424d8d13a5
9 files changed
+726
No files matched your search
@@ -0,0 +1,29 @@
|
||||
# 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/<sphere>/` 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 <sphere>` 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.
|
||||
Reference in new issue
Block a user