Servidor MCP de Cloudglue

Conecte Cloudglue a Cursor, Claude Desktop y otros asistentes de IA para desbloquear el poder de la comprensión de la recopilación de vídeos. Cloudglue ayuda a convertir sus vídeos en datos estructurados listos para LLM.

📖 Recursos

• Protocolo de contexto de modelo
• Documentos de la API de Cloudglue
• Condiciones del servicio
• Política de privacidad
• Precios

Al utilizar el SDK de Cloudglue y/o el servidor MCP, usted acepta las Condiciones de servicio de Cloudglue y reconoce nuestra Política de privacidad.

Configuración

1. Clave API

En primer lugar, obtenga una clave de API de Cloudglue en cloudglue.dev, que se utilizará para autenticar el servidor MCP con su cuenta de Cloudglue.

2. Configurar el cliente MCP

A continuación, configure su cliente MCP (por ejemplo, Claude Desktop) para utilizar este servidor MCP. La mayoría de los clientes MCP almacenan la configuración como JSON, para cloudglue-mcp-server esto tendría el siguiente aspecto:

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

Sustituya <CLOUDGLUE-YOUR-API-KEY> por la clave de API creada en el paso 1.

Configuración de desarrollo local

1. Clave API

En primer lugar, obtenga una clave de API de Cloudglue en cloudglue.dev, que se utilizará para autenticar el servidor MCP con su cuenta de Cloudglue.

2. Instale y cree el servidor localmente

Usted puede construir este servidor localmente a través de:

npm install npm run build

3. Configurar cliente MCP

A continuación, configura tu cliente MCP (como Cursor) para usar este servidor. La mayoría de los clientes MCP almacenan la configuración como JSON en el siguiente formato:

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

Herramientas

Las siguientes herramientas de Cloudglue están disponibles para los LLM a través de este servidor MCP:

Descubrimiento y navegación

• list_collections: Descubre las colecciones de vídeo disponibles y sus metadatos básicos. Utilícela primero para saber qué colecciones de vídeo existen antes de utilizar otras herramientas específicas de colección. Muestra los identificadores de colección necesarios para otras herramientas, el recuento de vídeos y los tipos de colección.

• list_videos: Explore y busque metadatos de vídeo con potentes opciones de filtrado. Utilícelo para explorar los vídeos disponibles, encontrar contenidos específicos por fecha o ver qué hay en una colección. Devuelve información esencial del vídeo, como la duración, el nombre del archivo y los identificadores necesarios para otras herramientas.

Análisis de vídeos individuales

• describir_vídeo: Obtenga transcripciones y descripciones completas de vídeos individuales (subidos a YouTube o Cloudglue) con optimización inteligente de costes. Comprueba automáticamente si existen transcripciones antes de crear otras nuevas. Utilícelo para el análisis de vídeos individuales; para analizar varios vídeos de una colección, utilice en su lugar retrieve_collection_transcripts. Admite tanto vídeos de YouTube como de Cloudglue con diferentes niveles de análisis.

• extract_video_entities: Extraiga datos estructurados y entidades de vídeos utilizando avisos personalizados con optimización inteligente de costes. Comprueba automáticamente las extracciones existentes antes de crear nuevas. Utilícelo para el análisis de vídeos individuales; para analizar varios vídeos de una colección, utilice en su lugar retrieve_collection_entities. La calidad de los resultados depende en gran medida de la especificidad de la solicitud.

• get_video_metadata: Obtiene metadatos técnicos completos sobre un archivo de vídeo de Cloudglue, incluyendo duración, resolución, tamaño del archivo, estado de procesamiento y estadísticas computadas. Utilícelo cuando necesite especificaciones de vídeo, detalles de archivo o información de procesamiento en lugar de análisis de contenido. Diferente de herramientas centradas en el contenido como describe_video.

Análisis de colecciones

• retrieve_transcript_summaries: Recupera de forma masiva resúmenes y títulos de vídeos de una colección para comprender rápidamente su contenido y temas. Perfecto para obtener una visión general de alto nivel de lo que hay en una colección, identificar temas comunes o determinar si una colección contiene contenido relevante para una consulta específica. Utilice esta opción como primer paso para analizar una colección: es más eficaz que recuperar transcripciones completas y le ayuda a determinar si necesita información más detallada. Pase a retrieve_collection_transcripts únicamente si necesita el contexto multimodal completo para vídeos específicos identificados a través de los resúmenes. Devuelve hasta 50 resúmenes por solicitud con soporte de paginación.

• recuperar_colección_transcripciones: Recupera de forma masiva transcripciones multimodales enriquecidas (texto, audio y visual) de una colección con filtrado avanzado. Utilícela sólo después de utilizar retrieve_transcript_summaries para identificar vídeos específicos que necesiten un análisis detallado. Esta herramienta consume más recursos y está limitada a 10 transcripciones por solicitud, por lo que es mejor utilizarla para el análisis específico de vídeos concretos que para una visión general de la colección. Para vídeos individuales, utilice en su lugar describe_video. Utilice el filtrado por fecha para centrarse en periodos de tiempo específicos.

• retrieve_collection_entities: Recupera por lotes datos de entidades estructuradas de varios vídeos de una colección. Las entidades pueden ser definidas por el usuario en función de lo que sea importante para su colección (personas, objetos, conceptos, categorías personalizadas). Perfecto para la minería de datos, la creación de conjuntos de datos o el análisis a escala de entidades extraídas previamente. Admite la paginación y el filtrado basado en fechas para gestionar grandes conjuntos de resultados. Para entidades de vídeo individuales, utilice en su lugar extract_video_entities.

• find_video_collection_moments: Búsqueda semántica basada en IA para encontrar momentos, temas o contenidos específicos dentro de una colección de vídeos. Devuelve segmentos relevantes con contexto, marcas de tiempo y citas. Perfecta para encontrar contenidos, debates específicos o análisis temáticos en varios vídeos. Mucho más específica que las herramientas de recuperación masiva.

Cuándo utilizar cada herramienta

• Empezar a explorar: Utilice list_collections y list_videos para explorar los contenidos disponibles
• Para vídeos individuales: Utilice describir_vídeo o extraer_entidades_de_vídeo
• Para una visión general de la colección: Empiece siempre con retrieve_transcript_summaries para comprender eficazmente el contenido de una colección
• Para un análisis detallado: Utilice retrieve_collection_transcripts sólo para vídeos específicos que necesiten un contexto multimodal completo, identificado a través de los resúmenes
• Para datos estructurados: Utilice retrieve_collection_entities para la extracción masiva de entidades
• Para contenidos específicos: Utilice find_video_collection_moments para la búsqueda semántica específica
• Para especificaciones técnicas: Utilice get_video_metadata

Todas las herramientas incluyen funciones inteligentes como la optimización de costes, la recuperación automática y la gestión exhaustiva de errores.

Póngase en contacto con

• Abrir una incidencia
• Envíe un correo electrónico a