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

Clonar este repositorio
Instalar las dependencias:
npm install
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

npm run build

Ejecución del servidor

Puedes ejecutar el servidor directamente:

npm start

Integración con Claude Desktop

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

{
  "mcpServers": {
    "video-generator": {
      "command": "node",
      "args": ["your_install_path/fal-mcp-server/build/index.js"],
      "env": {
        "FAL_KEY": "your_fal_key_here"
      }
    }
  }
}

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

猫が毛糸玉で遊んでいる動画を生成してください。縦向きモードでお願いします。Klingモデルを使用してください。

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)