Dacast MCP Live Stream Server

Serveur MCP Dacast

Ce dépôt fournit un serveur Model Context Protocol (MCP) qui expose l'API de la plateforme vidéo Dacast sous la forme d'un ensemble d'outils MCP structurés. Il permet aux clients compatibles MCP (tels que Claude Desktop) de gérer les ressources Dacast — chaînes, playlists, images, destinations de simulcast, et plus encore — en langage naturel.

---

Fonctionnalités

• Serveur MCP basé sur StdIO

  • Utilise le Model Context Protocol via l'entrée/sortie standard.
  • Conçu pour être lancé par un processus client MCP et maintenu en cours d'exécution en tant que processus enfant.

• Intégration de l'API Dacast

  • Gestion des chaînes : créer, lister, obtenir, mettre à jour.
  • Gestion des playlists : créer, lister, obtenir, mettre à jour, définir le contenu de la playlist.
  • Gestion des images : vignettes et images d'accueil.
  • Gestion des destinations de simulcast : créer, obtenir, supprimer.

---

Installation

Prérequis

• Go : Go 1.24+ (les versions antérieures peuvent fonctionner mais ne sont pas garanties).
• Compte Dacast et clé API : requis pour effectuer des opérations authentifiées.

Configuration du client MCP

Une configuration de client MCP basée sur JSON pourrait ressembler à ceci :

{
  "mcpServers": {
    "dacast": {
      "command": "go",
      "args": ["run", "github.com/Dacast-Inc/mcp-server-public@latest"],
      "env": {
        "DACAST_API_KEY": "DACAST API KEY HERE"
      }
    }
  }
}

Aperçu de l'architecture

Conception de haut niveau

Le serveur est un binaire Go unique qui :

1. Démarre un serveur MCP stdio.
2. Enregistre un ensemble d'outils regroupés par domaine Dacast (chaînes, playlists, images, simulcast).
3. Pour chaque requête MCP call_tool entrante :
   • Lie et valide les arguments de l'outil.
   • Construit une requête HTTP vers le point de terminaison REST Dacast approprié en utilisant le ApiClient interne.
   • Transmet la requête à Dacast avec les en-têtes d'authentification appropriés.
   • Renvoie la réponse JSON (et éventuellement une forme structurée et transformée) au client MCP.

Paquets clés :

• main.go – point d'entrée qui initialise le serveur MCP et enregistre les outils.
• pkg/apiclient/ – wrapper client HTTP minimal autour de l'API REST Dacast.
• pkg/tools/ – implémentations d'outils regroupées par domaine :
  • channel/ – opérations liées aux chaînes.
  • playlist/ – opérations liées aux playlists.
  • images/ – opérations sur les vignettes et les images d'accueil.
  • simulcast/ – opérations sur les destinations de simulcast.
• pkg/tools/toolscommon/ – types partagés, gestionnaires et utilitaires pour la construction d'outils.

Outils → Mappage de l'API Dacast

Chaque outil sous pkg/tools/ correspond à un ou plusieurs points de terminaison de l'API Dacast.

• Chaînes (pkg/tools/channel/)

  • create_channel.go – créer une nouvelle chaîne.
  • get_channel.go – obtenir les détails d'une chaîne.
  • update_channel.go – mettre à jour une chaîne existante.
  • list_channel.go – lister toutes les chaînes ou les filtrer.

• Playlists (pkg/tools/playlist/)

  • create_playlist.go – créer une nouvelle playlist.
  • get_playlist.go – obtenir les détails d'une playlist.
  • update_playlist.go – mettre à jour une playlist existante.
  • list_playlist.go – lister les playlists.
  • set_playlist_content.go – définir ou mettre à jour le contenu d'une playlist.

• Images (pkg/tools/images/)

  • thumbnail.go – gérer les vignettes des chaînes/ressources.
  • splash.go – gérer les images d'accueil.

• Simulcast (pkg/tools/simulcast/)

  • create_simulcast_destination.go – créer une destination de simulcast.
  • get_simulcast_destination.go – récupérer une destination de simulcast.
  • delete_simulcast_destination.go – supprimer une destination de simulcast.

---

Licence

Ce projet est sous licence selon les termes décrits dans le fichier LICENSE de ce dépôt. Veuillez consulter ce fichier pour le texte intégral.