Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Modelo Contexto Protocolo) es un protocolo de contexto de modelo lanzado por Anthropic, que permite a los modelos de IA (como Claude, GPT, etc.) llamar a herramientas externas a través de interfaces estandarizadas. A través del Luma MCP Server proporcionado por AceData Cloud, puedes generar videos de IA directamente en clientes de IA como Claude Desktop, VS Code, Cursor, etc.

​
Resumen de Funciones

Luma MCP Server ofrece las siguientes funciones clave:
  • Generación de video a partir de texto — Genera videos de alta calidad a partir de indicaciones de texto
  • Generación de video a partir de imágenes — Genera videos comenzando o terminando con imágenes
  • Continuación de video — Continúa generando desde el último fotograma de un video existente
  • Múltiples proporciones de pantalla — Soporta proporciones como 16:9, 9:16, 1:1, entre otras
  • Mejora de imagen — Función opcional de mejora de calidad visual
  • Consulta de tareas — Monitorea el progreso de generación y obtiene resultados

​
Preparativos Previos

Antes de usar, necesitas obtener un Token de API de AceData Cloud:
  1. Regístrate o inicia sesión en la plataforma AceData Cloud
  2. Ve a la página de API de Luma Videos
  3. Haz clic en “Acquire” para obtener el Token de API (se ofrece un crédito gratuito en la primera solicitud)

​
Instalación y Configuración

​
Método 1: Instalación con pip (recomendado)

pip install mcp-luma

​
Método 2: Instalación desde el código fuente

git clone https://github.com/AceDataCloud/MCPLuma.git
cd MCPLuma
pip install -e .
Una vez completada la instalación, puedes usar el comando mcp-luma para iniciar el servicio.

​
Uso en Claude Desktop

Edita el archivo de configuración de Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Agrega la siguiente configuración: 
{
  "mcpServers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}
Si usas uvx (sin necesidad de instalar paquetes previamente): 
{
  "mcpServers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}
Guarda la configuración y reinicia Claude Desktop para poder usar las herramientas relacionadas con Luma en la conversación.

​
Uso en VS Code / Cursor

Crea un archivo .vscode/mcp.json en el directorio raíz del proyecto: 
{
  "servers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}
O usa uvx: 
{
  "servers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

​
Lista de Herramientas Disponibles

Nombre de la herramientaDescripción
luma_generate_videoGenera video a partir de texto
luma_generate_video_from_imageGenera video a partir de una imagen
luma_extend_videoContinúa un video existente
luma_extend_video_from_urlContinúa un video especificado por URL
luma_get_taskConsulta el estado de una tarea
luma_get_tasks_batchConsulta el estado de tareas en lote

​
Ejemplos de Uso

Una vez configurado, puedes llamar a estas funciones directamente en el cliente de IA usando lenguaje natural, por ejemplo:
  • “Ayúdame a generar un video de un atardecer en la playa”
  • “Usa esta foto como primer fotograma y genera un video de 5 segundos”
  • “Continúa este video y alarga un poco más”
  • “Genera un video en vertical, proporción 9:16”

​
Más Información