main
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 (
/mcpet/). - Réseau Docker :
mcp-vps. - Ports d'écoute : Publié strictement sur
127.0.0.1:3106et100.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 viaTREBLO_MCP_TOKEN_NYORAet jeton Perso viaTREBLO_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.
- Aucun montage de
Les 4 Outils MCP
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.statut(task_id): Consulte l'état d'avancement d'une tâche de génération auprès de Treblo.recuperer(task_id, sphere): Télécharge les fichiers générés (FLAC ou WAV pour l'archive, MP3 pour l'écoute) dansmusique/<sphere>/avec le fichier JSON de métadonnées associé.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.jsonlavec empreinte SHA-256 du prompt/paroles, sans jamais enregistrer de clé ni de jeton.
Languages
Python
99.2%
Dockerfile
0.8%