Serveur Cloudglue MCP

Connectez Cloudglue à Cursor, Claude Desktop et d'autres assistants d'IA pour libérer la puissance de la compréhension de la collecte de vidéos. Cloudglue aide à transformer vos vidéos en données structurées prêtes pour les MCP.

📖 Ressources

• Modèle Contexte Protocole
• Docs de l'API Cloudglue
• Conditions d'utilisation
• Politique de confidentialité
• Prix

En utilisant le SDK Cloudglue et/ou le serveur MCP, vous acceptez les conditions d'utilisation de Cloudglue et reconnaissez notre politique de confidentialité.

Configuration

1. Clé API

Tout d'abord, obtenez une clé API Cloudglue à partir de cloudglue.dev, elle sera utilisée pour authentifier le serveur MCP avec votre compte Cloudglue.

2. Configurer le client MCP

Ensuite, configurez votre client MCP (par exemple Claude Desktop) pour utiliser ce serveur MCP. La plupart des clients MCP stockent la configuration sous forme de JSON, pour cloudglue-mcp-server cela ressemblerait à ce qui suit :

{ "mcpServers" : { "cloudglue" : { "command" : "npx", "args" : ["-y", "@aviaryhq/cloudglue-mcp-server@latest", "--api-key", "<CLOUDGLUE-YOUR-API-KEY>" ] } } }

Remplacez <CLOUDGLUE-YOUR-API-KEY> par la clé API créée à l'étape 1.

Configuration du développement local

1. Clé API

Tout d'abord, obtenez une clé API Cloudglue à partir de cloudglue.dev, qui sera utilisée pour authentifier le serveur MCP avec votre compte Cloudglue.

2. Installer et construire le serveur localement

Vous pouvez construire ce serveur localement via :

npm install npm run build

3. Configurer le client MCP

Ensuite, configurez votre client MCP (tel que Cursor) pour utiliser ce serveur. La plupart des clients MCP stockent la configuration sous forme de JSON dans le format suivant :

{ "mcpServers" : { "cloudglue-mcp-server" : { "command" : "node", "args" : ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/cloudglue-mcp-server/build/index.js", "--api-key", "<CLOUDGLUE-YOUR-API-KEY>" ] } } }

Outils

Les outils Cloudglue suivants sont disponibles pour les LLM via ce serveur MCP :

Découverte et navigation

• list_collections: Découvrez les collections vidéo disponibles et leurs métadonnées de base. Utilisez-le d'abord pour comprendre quelles collections vidéo existent avant d'utiliser d'autres outils spécifiques aux collections. Indique les identifiants de collection nécessaires pour d'autres outils, le nombre de vidéos et les types de collection.

• list_videos: Permet de parcourir et de rechercher des métadonnées vidéo à l'aide d'options de filtrage puissantes. Cette fonction permet d'explorer les vidéos disponibles, de trouver un contenu spécifique par date ou de voir le contenu d'une collection. Renvoie des informations essentielles sur la vidéo, telles que la durée, le nom de fichier et les identifiants nécessaires aux autres outils.

Analyse de vidéos individuelles

• décrire_vidéo: Obtenez des transcriptions et des descriptions complètes à partir de vidéos individuelles (chargement YouTube ou Cloudglue) avec une optimisation intelligente des coûts. Cette fonction vérifie automatiquement les transcriptions existantes avant d'en créer de nouvelles. Utilisez cette fonction pour l'analyse de vidéos individuelles. Pour l'analyse de plusieurs vidéos d'une collection, utilisez plutôt retrieve_collection_transcripts. Prend en charge les vidéos YouTube et Cloudglue avec différents niveaux d'analyse.

• extract_video_entities: Extraction de données structurées et d'entités à partir de vidéos à l'aide d'invites personnalisées et d'une optimisation intelligente des coûts. Vérifie automatiquement les extractions existantes avant d'en créer de nouvelles. Utilisez cette fonction pour l'analyse de vidéos individuelles. Pour l'analyse de plusieurs vidéos d'une collection, utilisez plutôt retrieve_collection_entities. La qualité des résultats dépend fortement de la spécificité de votre requête.

• get_video_metadata: Permet d'obtenir des métadonnées techniques complètes sur un fichier vidéo Cloudglue, notamment la durée, la résolution, la taille du fichier, l'état de traitement et les statistiques calculées. Utilisez cette fonction lorsque vous avez besoin de spécifications vidéo, de détails sur les fichiers ou d'informations sur le traitement plutôt que d'une analyse du contenu. Différent des outils axés sur le contenu tels que describe_video.

Analyse de collection

• retrieve_transcript_summaries: Récupère en masse les titres et les résumés des vidéos d'une collection pour en comprendre rapidement le contenu et les thèmes. Parfait pour obtenir une vue d'ensemble du contenu d'une collection, identifier les sujets communs ou déterminer si une collection contient un contenu pertinent pour une requête spécifique. Il s'agit de la première étape de l'analyse d'une collection. Elle est plus efficace que l'extraction des transcriptions complètes et vous aide à déterminer si vous avez besoin d'informations plus détaillées. Ne passez à retrieve_collection_transcripts que si vous avez besoin du contexte multimodal complet pour des vidéos spécifiques identifiées par les résumés. Renvoie jusqu'à 50 résumés par requête avec prise en charge de la pagination.

• retrieve_collection_transcripts: Récupère en masse des transcriptions multimodales riches (texte, audio et visuel) à partir d'une collection avec un filtrage avancé. N'utilisez cet outil qu'après avoir utilisé retrieve_transcript_summaries pour identifier des vidéos spécifiques nécessitant une analyse détaillée. Cet outil est plus gourmand en ressources et limité à 10 transcriptions par requête. Il est donc préférable de l'utiliser pour l'analyse ciblée de vidéos spécifiques plutôt que pour une vue d'ensemble de la collection. Pour les vidéos individuelles, utilisez plutôt describe_video. Utilisez le filtrage par date pour vous concentrer sur des périodes spécifiques.

• retrieve_collection_entities: Récupère par lots des données d'entités structurées à partir de plusieurs vidéos d'une collection. Les entités peuvent être définies par l'utilisateur en fonction de ce qui est important pour votre collection (personnes, objets, concepts, catégories personnalisées). Parfait pour l'exploration de données, la constitution d'ensembles de données ou l'analyse à grande échelle d'entités précédemment extraites. Prend en charge la pagination et le filtrage basé sur la date pour gérer les grands ensembles de résultats. Pour les entités vidéo individuelles, utilisez plutôt extract_video_entities.

• find_video_collection_moments: Recherche sémantique assistée par l'IA pour trouver des moments, des sujets ou des contenus spécifiques dans une collection de vidéos. Elle renvoie les segments pertinents avec le contexte, les horodatages et les citations. Parfait pour trouver du contenu dans une pile de foin, des discussions spécifiques ou une analyse thématique dans plusieurs vidéos. Beaucoup plus ciblé que les outils de recherche en masse.

Quand utiliser quel outil ?

• Commencez à explorer: Utilisez list_collections et list_videos pour explorer le contenu disponible
• Pour les vidéos individuelles: Utilisez describe_video ou extract_video_entities
• Pour une vue d'ensemble de la collection: Commencez toujours par retrieve_transcript_summaries pour comprendre efficacement le contenu d'une collection
• Pour une analyse détaillée: N'utilisez retrieve_collection_transcripts que pour les vidéos spécifiques qui nécessitent un contexte multimodal complet, identifié par les résumés
• Pour les données structurées: Utilisez retrieve_collection_entities pour l'extraction d'entités en vrac
• Pour un contenu spécifique: Utilisez find_video_collection_moments pour une recherche sémantique ciblée
• Pour les spécifications techniques: Utiliser get_video_metadata

Tous les outils comprennent des fonctions intelligentes telles que l'optimisation des coûts, des solutions de repli automatiques et une gestion complète des erreurs.

Contact

• Ouvrir un dossier
• Courriel