Luma AI MCP Server

Genera y manipula videos e imágenes con IA usando la API de Dream Machine de Luma AI.

Documentación

Luma AI MCP Server 🎥

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 de Luma AI (v1) para proporcionar herramientas para generar, gestionar y manipular videos e imágenes generados por IA a través de Modelos de Lenguaje Grande. Implementa el Protocolo de Contexto de Modelo (MCP) para permitir una interacción fluida entre asistentes de IA y las herramientas creativas de Luma.

Características ✨

Generación de texto a video
Generación avanzada de video con fotogramas clave
Conversión de imagen a video
Extensión e interpolación de video
Generación de imágenes con imágenes de referencia
Adición de audio a videos
Mejora de resolución de video
Gestión de créditos
Seguimiento de generaciones y verificación de estado

Herramientas 🛠️

ping
- Verifica si la API de Luma está en funcionamiento
- No requiere parámetros
create_generation
- Crea una nueva generación de video
- Entrada:
  - prompt (cadena, obligatorio): Descripción textual 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 del video (opciones: "540p", "720p", "1080p", "4k")
  - duration (cadena, opcional): Duración del video (actualmente solo se admiten "5s" y "9s")
  - aspect_ratio (cadena, opcional): Relación de aspecto del video (p. ej., "16:9", "1:1", "9:16", "4:3", "3:4", "21:9", "9:21")
  - loop (booleano, opcional): Si se debe hacer que el video se repita en bucle
  - keyframes (objeto, opcional): Fotogramas de inicio y fin para generación avanzada de video:
    - frame0 y/o frame1 con cualquiera de:
      - {"type": "image", "url": "image_url"} para fotogramas clave de imagen
      - {"type": "generation", "id": "generation_id"} para fotogramas clave de video
get_generation
- Obtiene el estado de una generación
- Entrada:
  - generation_id (cadena, obligatorio): ID de la generación a verificar
- La salida incluye:
  - ID de la generación
  - Estado (en cola, procesando, completado, fallido)
  - Motivo del fallo (si falló)
  - URL del video (si se completó)
list_generations
- Lista todas las generaciones
- Entrada:
  - 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
- Entrada:
  - generation_id (cadena, obligatorio): ID de la generación a eliminar
upscale_generation
- Mejora la resolución de una generación de video a una resolución más alta
- Entrada:
  - generation_id (cadena, obligatorio): ID de la generación a mejorar
  - resolution (cadena, obligatorio): Resolución objetivo para el video mejorado (una de "540p", "720p", "1080p" o "4k")
- Nota:
  - La generación debe estar en estado completado para poder mejorarse
  - La resolución objetivo debe ser mayor que la resolución de la generación original
  - Cada generación solo puede mejorarse una vez
add_audio
- Agrega audio generado por IA a una generación de video
- Entrada:
  - generation_id (obligatorio): El ID de la generación a la que se agregará audio
  - prompt (obligatorio): El prompt para la generación de audio
  - negative_prompt (opcional): El prompt negativo para la generación de audio
  - callback_url (opcional): URL para notificar cuando se complete el procesamiento del audio
generate_image
- Genera una imagen a partir de un prompt de texto con imágenes de referencia opcionales
- Entrada:
  - prompt (cadena, obligatorio): Descripción textual 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 (mismas opciones que para video)
  - 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 personaje
    - 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éditos para el usuario actual
- No requiere parámetros
- Devuelve el saldo de créditos disponible en centavos de dólar
get_camera_motions
- Obtiene todos los movimientos de cámara admitidos
- No requiere parámetros
- Devuelve: Lista de cadenas de movimientos de cámara disponibles

Configuración para Claude Desktop 🖥️

Obtén tu clave de API de Luma en Luma AI (regístrate o inicia sesión para obtener tu clave de API)
Agrega esto a tu 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"
      }
    }
  }
}
```
Reemplaza:
- /path/to/your/luma-ai-mcp-server con la ruta real a tu directorio del servidor
- your-luma-api-key-here con tu clave de API real de Luma
Reinicia Claude Desktop
¡Eso es todo! Ahora puedes usar las herramientas de Luma AI directamente en las conversaciones de Claude Desktop.

Solución rápida de problemas 🛠️

Si tienes problemas:

Verifica que tu clave de API sea correcta
Asegúrate de que la ruta al servidor sea correcta
Consulta los registros con: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Tipos avanzados de generación de video 🎬

La API de Luma admite varios tipos de generación avanzada de video mediante fotogramas clave:

Comenzar desde una imagen: Proporciona frame0 con type: "image" y una URL de imagen
Terminar con una imagen: Proporciona frame1 con type: "image" y una URL de imagen
Extender un video: Proporciona frame0 con type: "generation" y un ID de generación
Extender un video en reversa: Proporciona frame1 con type: "generation" y un ID de generación
Interpolar entre videos: Proporciona tanto frame0 como frame1 con type: "generation" e IDs de generación

Limitaciones y notas de la API 📝

Duración: Actualmente, la API solo admite duraciones de "5s" o "9s"
Resolución: Los valores válidos son "540p", "720p", "1080p" y "4k"
Modelos:
- Generación de video:
  - "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: Video, 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" (ultrapanorámico), "9:21" (vertical ultrapanorámico)
Estados: "en cola", "procesando", "completado", "fallido"
Mejora de resolución:
- Las generaciones de video solo pueden mejorarse cuando están en estado "completado"
- La resolución objetivo debe ser mayor que la resolución de la generación original
- Cada generación solo puede mejorarse una vez
Clave de API: Requerida en las variables de entorno
Versión de la API: Utiliza Dream Machine API v1

Licencia 📄

MIT