Servidor MCP del generador de video de IA

Este servidor MCP (Protocolo de contexto de modelo) proporciona herramientas para generar videos a partir de indicaciones de texto e imágenes utilizando modelos de generación de imágenes de IA.

Modelos compatibles

• Luma Ray2 Flash : el modelo de conversión de imagen a vídeo de vanguardia de Luma

• Kling v1.6 Pro : el modelo de conversión de imágenes a vídeos de alta calidad de Kling

función

• Generación de vídeo a partir de indicaciones de texto

• Generación de vídeo con imágenes de inicio y/o fin

• Controlar los parámetros de vídeo (relación de aspecto, resolución, duración, bucle)

• Comprobar el estado de la generación

• Elegir qué modelo de IA utilizar

instalar

1. Clonar este repositorio

2. Instalar las dependencias:

   npm install

3. Cree un archivo .env y configure su clave API FAL.AI:

   FAL_KEY=your_fal_key_here

   Puede obtener la clave API de FAL.AI

Construyendo el servidor

Ejecución del servidor

Puedes ejecutar el servidor directamente:

Integración con Claude Desktop

Para utilizar este servidor con Claude Desktop, agregue lo siguiente a su archivo claude_desktop_config.json :

Herramientas disponibles

generar video

Utiliza modelos de IA para generar vídeos a partir de indicaciones de texto y/o imágenes.

Parámetros:

• prompt (obligatorio): una descripción de texto del contenido del vídeo que desea generar.

• image_url (opcional): la URL de la imagen inicial del video (URL o URI de datos base64).

• end_image_url (opcional): la URL de la imagen final del video (URL o URI de datos base64).

• aspect_ratio (predeterminado "16:9"): Relación de aspecto del vídeo ("16:9", "9:16", "4:3", "3:4", "21:9", "9:21")

• resolution (predeterminada "540p"): Resolución de vídeo ("540p", "720p", "1080p")

• duration (predeterminado "5 s"): duración del vídeo ("5 s", "9 s")

• loop (predeterminado falso): si el vídeo debe repetirse

• model (predeterminado "luma"): modelo de IA a utilizar ("luma"=Ray2, "kling"=Kling v1.6 Pro)

comprobar el estado del vídeo

Verifique el estado de su solicitud de generación de vídeo.

Parámetros:

• request_id (obligatorio): El ID de la solicitud a verificar.

• model (predeterminado "luma"): modelo de IA utilizado para la solicitud ("luma"=Ray2, "kling"=Kling v1.6 Pro)

Ejemplo de uso de Claude

Claude llama a la herramienta generate-video con los parámetros apropiados y proporciona la URL del video resultante.

Comparar modelos

• Flash Luma Ray2 : excelente para movimientos suaves y física realista, produciendo resultados naturales.

• Kling v1.6 Pro : Excelente para texturas detalladas y efectos especiales, produciendo resultados estilizados.

Dependiendo del mensaje y del resultado deseado, distintos modelos pueden funcionar mejor.

Limitaciones

• La generación de video puede tardar algún tiempo (especialmente en resoluciones más altas)

• Se requiere una clave API FAL.AI válida y créditos suficientes

• Los vídeos de mayor resolución y más largos cuestan más créditos.

• Ambos modelos consumen créditos FAL.AI (los precios pueden variar según el modelo)

solución de problemas

Error de clave API

Verifique que la variable de entorno FAL_KEY esté configurada correctamente. También se puede configurar directamente en el archivo de configuración de Claude Desktop.

Error de generación de vídeo

Si ocurre un error durante la generación de vídeo, se registrará un mensaje de error detallado. Los problemas comunes son:

• Clave API no válida o caducada

• Créditos insuficientes en su cuenta

• Indicaciones o imágenes inapropiadas

• Un problema temporal del lado del servidor

Si el error persiste, espere un momento e inténtelo nuevamente o intente cambiar el mensaje.

licencia

Instituto Tecnológico de Massachusetts (MIT)