Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

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

MCP (Model Context Protocol) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas através de interfaces padronizadas. Com o Luma MCP Server fornecido pela XHuoAPI, você pode gerar vídeos de IA diretamente em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

​
Visão Geral das Funcionalidades

O Luma MCP Server oferece as seguintes funcionalidades principais:
  • Geração de vídeo a partir de texto — Gera vídeos de alta qualidade a partir de prompts de texto
  • Geração de vídeo a partir de imagem — Gera vídeos a partir de uma imagem como ponto de partida ou de chegada
  • Continuação de vídeo — Continua a geração a partir do último quadro de um vídeo existente
  • Vários formatos de tela — Suporta vários formatos como 16:9, 9:16, 1:1, entre outros
  • Aprimoramento de imagem — Função opcional de melhoria da qualidade visual
  • Consulta de tarefas — Monitora o progresso da geração e obtém resultados

​
Preparativos

Antes de usar, você precisa obter o Token da API da XHuoAPI:
  1. Registre-se ou faça login na plataforma XHuoAPI
  2. Vá para a página da API de Vídeos Luma
  3. Clique em “Acquire” para obter o Token da API (primeira solicitação oferece crédito gratuito)

​
Instalação e Configuração

​
Método 1: Instalação via pip (recomendado)

pip install mcp-luma

​
Método 2: Instalação a partir do código-fonte

git clone https://github.com/XHuoAPI/LumaMCP.git
cd LumaMCP
pip install -e .
Após a instalação, você pode usar o comando mcp-luma para iniciar o serviço.

​
Usando no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a seguinte configuração: 
{
  "mcpServers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Se usar uvx (sem necessidade de instalação prévia do pacote): 
{
  "mcpServers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Salve a configuração e reinicie o Claude Desktop para usar as ferramentas relacionadas ao Luma na conversa.

​
Usando no VS Code / Cursor

Crie um arquivo .vscode/mcp.json no diretório raiz do projeto: 
{
  "servers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Ou use uvx: 
{
  "servers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}

​
Lista de Ferramentas Disponíveis

Nome da FerramentaDescrição
luma_generate_videoGera vídeo a partir de texto
luma_generate_video_from_imageGera vídeo a partir de imagem
luma_extend_videoContinua vídeo existente
luma_extend_video_from_urlContinua vídeo a partir de URL
luma_get_taskConsulta o status de uma tarefa
luma_get_tasks_batchConsulta o status de várias tarefas

​
Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural em clientes de IA, por exemplo:
  • “Ajude-me a gerar um vídeo de um pôr do sol na praia”
  • “Use esta foto como o primeiro quadro e gere um vídeo de 5 segundos”
  • “Continue este vídeo e estenda por mais um trecho”
  • “Gere um vídeo em modo retrato, proporção 9:16”

​
Mais Informações