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

# Guida all'integrazione Luma MCP

> luma MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è un protocollo di contesto del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il Luma MCP Server fornito da XHuoAPI, puoi generare video AI direttamente nei client AI come Claude Desktop, VS Code, Cursor, ecc.

## Panoramica delle funzionalità

Il Luma MCP Server offre le seguenti funzionalità principali:

* **Generazione video da testo** — Genera video di alta qualità tramite suggerimenti testuali
* **Generazione video da immagini** — Genera video partendo o arrivando a un'immagine
* **Continuazione video** — Continua a generare dal fotogramma finale di un video esistente
* **Vari rapporti d'aspetto** — Supporta vari rapporti come 16:9, 9:16, 1:1, ecc.
* **Miglioramento visivo** — Funzione opzionale di miglioramento della qualità visiva
* **Query di stato** — Monitora il progresso della generazione e ottieni risultati

## Preparativi preliminari

Prima di utilizzare, devi ottenere il Token API di XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Luma Videos API](https://api.xhuoapi.ai/documents/luma-videos)
3. Clicca su "Acquire" per ottenere il Token API (il primo acquisto include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione con pip (consigliato)

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

### Metodo 2: installazione da sorgente

```bash theme={null}
git clone https://github.com/XHuoAPI/LumaMCP.git
cd LumaMCP
pip install -e .
```

Dopo l'installazione, puoi avviare il servizio utilizzando il comando `mcp-luma`.

## Utilizzo in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Aggiungi la seguente configurazione:

```json theme={null}
{
  "mcpServers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Se utilizzi `uvx` (non è necessario installare pacchetti in anticipo):

```json theme={null}
{
  "mcpServers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Dopo aver salvato la configurazione, riavvia Claude Desktop per utilizzare gli strumenti relativi a Luma nella conversazione.

## Utilizzo in VS Code / Cursor

Crea `.vscode/mcp.json` nella directory principale del progetto:

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

Oppure utilizza `uvx`:

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

## Elenco degli strumenti disponibili

| Nome dello strumento             | Descrizione                                |
| -------------------------------- | ------------------------------------------ |
| `luma_generate_video`            | Genera video tramite suggerimenti testuali |
| `luma_generate_video_from_image` | Genera video da un'immagine                |
| `luma_extend_video`              | Continua un video esistente                |
| `luma_extend_video_from_url`     | Continua un video specificato da un URL    |
| `luma_get_task`                  | Consulta lo stato di un singolo compito    |
| `luma_get_tasks_batch`           | Consulta lo stato di più compiti           |

## Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare queste funzionalità direttamente in linguaggio naturale nei client AI, ad esempio:

* "Aiutami a generare un video di un tramonto al mare"
* "Usa questa foto come primo fotogramma e genera un video di 5 secondi"
* "Continua questo video e allunga un po' di più"
* "Genera un video in verticale, rapporto 9:16"

## Maggiori informazioni

* Repository GitHub: [XHuoAPI/LumaMCP](https://github.com/XHuoAPI/LumaMCP)
* Pacchetto PyPI: [mcp-luma](https://pypi.org/project/mcp-luma/)
* Documentazione API: [API di generazione video Luma](https://api.xhuoapi.ai/documents/luma)