Servidor MCP de Luma AI 🎥

Un servidor de protocolo de contexto de modelo para la API Dream Machine de Luma AI.

Descripción general

Este servidor MCP se integra con la API Dream Machine (v1) de Luma AI para proporcionar herramientas que permiten generar, gestionar y manipular vídeos e imágenes generados por IA mediante Modelos de Lenguaje Grandes. Implementa el Protocolo de Contexto de Modelo (MCP) para facilitar la interacción fluida entre los asistentes de IA y las herramientas creativas de Luma.

Características ✨

• Generación de texto a vídeo

• Generación avanzada de vídeo con fotogramas clave

• Conversión de imagen a vídeo

• Extensión e interpolación de vídeo

• Generación de imágenes con imágenes de referencia

• Adición de audio a los vídeos

• Escalado de vídeo

• Gestión de crédito

• Seguimiento de generación y verificación de estado

Herramientas 🛠️

1. ping

   • Comprueba si la API de Luma se está ejecutando

   • No se requieren parámetros

2. create_generation

   • Crea una nueva generación de vídeo.

   • Aporte:

     • prompt (cadena, obligatorio): Descripción de texto del video a generar

     • model (cadena, opcional): Modelo a utilizar (predeterminado: "ray-2")

       • Modelos disponibles: "ray-1-6", "ray-2", "ray-flash-2"

     • resolution (cadena, opcional): Resolución de vídeo (opciones: "540p", "720p", "1080p", "4k")

     • duration (cadena, opcional): duración del vídeo (actualmente solo se admiten "5 s" y "9 s")

     • aspect_ratio (cadena, opcional): Relación de aspecto del vídeo (p. ej., "16:9", "1:1", "9:16", "4:3", "3:4", "21:9", "9:21")

     • loop (booleano, opcional): si se debe hacer un bucle del video

     • keyframes (objeto, opcional): fotogramas de inicio y fin para la generación avanzada de vídeo:

       • frame0 y/o frame1 con:

         • {"type": "image", "url": "image_url"} para fotogramas clave de imagen

         • {"type": "generation", "id": "generation_id"} para fotogramas clave de vídeo

3. get_generation

   • Obtiene el estado de una generación.

   • Aporte:

     • generation_id (cadena, obligatoria): ID de la generación a comprobar

   • La salida incluye:

     • ID de generación

     • Estado (en cola, soñando, completado, fallido)

     • Motivo del fallo (si falló)

     • URL del vídeo (si se completó)

4. list_generations

   • Enumera todas las generaciones

   • Aporte:

     • limit (número, opcional): número máximo de generaciones a devolver (predeterminado: 10)

     • offset (número, opcional): Número de generaciones a omitir

5. delete_generation

   • Elimina una generación

   • Aporte:

     • generation_id (cadena, obligatoria): ID de la generación a eliminar

6. upscale_generation

   • Aumenta la resolución de una generación de vídeo

   • Aporte:

     • generation_id (cadena, obligatoria): ID de la generación a escalar

     • resolution (cadena, obligatoria): Resolución de destino para el video ampliado (una de "540p", "720p", "1080p" o "4k")

   • Nota:

     • La generación debe estar en un estado completo para poder ser ampliada.

     • La resolución de destino debe ser mayor que la resolución de la generación original.

     • Cada generación solo se puede ampliar una vez

7. add_audio

   • Agrega audio generado por IA a una generación de video.

   • Aporte:

     • generation_id (obligatorio): El ID de la generación a la que se agregará audio

     • prompt (obligatorio): El mensaje para la generación de audio

     • negative_prompt (opcional): el mensaje negativo para la generación de audio

     • callback_url (opcional): URL para notificar cuando se completa el procesamiento del audio

8. generate_image

   • Genera una imagen a partir de un mensaje de texto con imágenes de referencia opcionales.

   • Aporte:

     • prompt (cadena, obligatorio): Descripción de texto de la imagen a generar

     • model (cadena, opcional): Modelo a utilizar para la generación de imágenes (predeterminado: "photon-1")

       • Modelos disponibles: "photon-1", "photon-flash-1"

     • aspect_ratio (cadena, opcional): relación de aspecto de la imagen (las mismas opciones que el vídeo)

     • image_ref (matriz, opcional): Imágenes de referencia para guiar la generación

       • Cada referencia: {"url": "image_url", "weight": optional_float}

     • style_ref (matriz, opcional): imágenes de referencia de estilo

       • Cada referencia: {"url": "image_url", "weight": optional_float}

     • character_ref (objeto, opcional): Imágenes de referencia de personajes

       • Formato: {"identity_name": {"images": ["url1", "url2", ...]}}

     • modify_image_ref (objeto, opcional): Imagen a modificar

       • Formato: {"url": "image_url", "weight": optional_float}

9. get_credits

   • Obtiene información de crédito del usuario actual

   • No se requieren parámetros

   • Devuelve el saldo de crédito disponible en centavos de USD

10. get_camera_motions

• Obtiene todos los movimientos de cámara admitidos

• No se requieren parámetros

• Devuelve: Lista de cadenas de movimiento de cámara disponibles

Configuración para Claude Desktop 🖥️

1. Obtén tu clave API de Luma de Luma AI (regístrate o inicia sesión para obtener tu clave API)

2. Agregue esto a su archivo de configuración de Claude Desktop:

   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • En Windows: %APPDATA%\Claude\claude_desktop_config.json

   { "mcpServers": { "luma": { "command": "uv", "args": [ "run", "--project", "/path/to/your/luma-ai-mcp-server", "-m", "luma_ai_mcp_server" ], "env": { "LUMA_API_KEY": "your-luma-api-key-here" } } } }

   Reemplazar:

   • /path/to/your/luma-ai-mcp-server con la ruta real al directorio de su servidor

   • your-luma-api-key-here con su clave API de Luma real

3. Reiniciar Claude Desktop

4. ¡Listo! Ya puedes usar las herramientas de IA de Luma directamente en las conversaciones de Claude Desktop.

Solución rápida de problemas 🛠️

Si tienes problemas:

1. Comprueba que tu clave API sea correcta

2. Asegúrese de que la ruta al servidor sea correcta

3. Ver registros con: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Tipos avanzados de generación de vídeo 🎬

La API de Luma admite varios tipos de generación de vídeo avanzada a través de fotogramas clave:

1. A partir de una imagen : proporcione frame0 con type: "image" y una URL de imagen

2. Terminar con una imagen : proporcione frame1 con type: "image" y una URL de imagen

3. Ampliación de un vídeo : proporcione frame0 con type: "generation" y un ID de generación

4. Extensión inversa de un video : proporcione frame1 con type: "generation" y un ID de generación

5. Interpolación entre vídeos : proporcione tanto frame0 como frame1 con type: "generation" e ID de generación

Limitaciones y notas de la API 📝

• Duración : Actualmente, la API solo admite duraciones de "5 s" o "9 s".

• Resolución : Los valores válidos son "540p", "720p", "1080p" y "4k".

• Modelos :

  • Generación de vídeo:

    • "ray-2" (predeterminado): mejor calidad, más lento

    • "ray-flash-2": Generación más rápida

    • "ray-1-6" - Modelo heredado

  • Generación de imágenes:

    • "photon-1" (predeterminado): mejor calidad, más lento

    • "photon-flash-1": Generación más rápida

• Tipos de generación : Vídeo, imagen y avanzado (con fotogramas clave)

• Relaciones de aspecto : "1:1" (cuadrado), "16:9" (horizontal), "9:16" (vertical), "4:3" (estándar), "3:4" (vertical estándar), "21:9" (ultraancho), "9:21" (ultraancho vertical)

• Estados : "en cola", "soñando", "completado", "fallido"

• Ampliación de escala :

  • Las generaciones de video solo se pueden ampliar cuando están en un estado "completo"

  • La resolución del objetivo debe ser mayor que la resolución de la generación original

  • Cada generación solo se puede ampliar una vez

• Clave API : requerida en las variables de entorno

• Versión de API : utiliza Dream Machine API v1

Licencia 📄

Instituto Tecnológico de Massachusetts (MIT)