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.
S
Description
Serveur MCP Treblo musique pour Nyora et Perso
Readme
91 KiB
0 Stars 1 Watchers 0 Forks
Languages
Python 99.2%
Dockerfile 0.8%