> ## 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.

# Luma MCP Guia de Integração

> luma MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) é 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](https://api.xhuoapi.ai)
2. Vá para a página da [API de Vídeos Luma](https://api.xhuoapi.ai/documents/luma-videos)
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)

```bash theme={null}
pip install mcp-luma
```

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

```bash theme={null}
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:

```json theme={null}
{
  "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):

```json theme={null}
{
  "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:

```json theme={null}
{
  "servers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
```

Ou use `uvx`:

```json theme={null}
{
  "servers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
```

## Lista de Ferramentas Disponíveis

| Nome da Ferramenta               | Descrição                           |
| -------------------------------- | ----------------------------------- |
| `luma_generate_video`            | Gera vídeo a partir de texto        |
| `luma_generate_video_from_image` | Gera vídeo a partir de imagem       |
| `luma_extend_video`              | Continua vídeo existente            |
| `luma_extend_video_from_url`     | Continua vídeo a partir de URL      |
| `luma_get_task`                  | Consulta o status de uma tarefa     |
| `luma_get_tasks_batch`           | Consulta 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

* Repositório no GitHub: [XHuoAPI/LumaMCP](https://github.com/XHuoAPI/LumaMCP)
* Pacote PyPI: [mcp-luma](https://pypi.org/project/mcp-luma/)
* Documentação da API: [API de Geração de Vídeos Luma](https://api.xhuoapi.ai/documents/luma)