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 🛠️

ping
- Comprueba si la API de Luma se está ejecutando
- No se requieren parámetros
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
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ó)
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
delete_generation
- Elimina una generación
- Aporte:
  - generation_id (cadena, obligatoria): ID de la generación a eliminar
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
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
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}
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
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 🖥️

Obtén tu clave API de Luma de Luma AI (regístrate o inicia sesión para obtener tu clave API)
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
Reiniciar Claude Desktop
¡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:

Comprueba que tu clave API sea correcta
Asegúrese de que la ruta al servidor sea correcta
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:

A partir de una imagen : proporcione frame0 con type: "image" y una URL de imagen
Terminar con una imagen : proporcione frame1 con type: "image" y una URL de imagen
Ampliación de un vídeo : proporcione frame0 con type: "generation" y un ID de generación
Extensión inversa de un video : proporcione frame1 con type: "generation" y un ID de generación
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)

mcp-luma-dream-machine

Integrations