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

> luma MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) ist ein von Anthropic eingeführtes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Tools über standardisierte Schnittstellen aufzurufen. Über den von XHuoAPI bereitgestellten Luma MCP Server kannst du direkt in AI-Clients wie Claude Desktop, VS Code, Cursor usw. KI-Videos generieren.

## Funktionsübersicht

Der Luma MCP Server bietet folgende Kernfunktionen:

* **Textgenerierung zu Video** — Hochwertige Videos aus Textaufforderungen generieren
* **Bildgenerierung zu Video** — Videos aus Bildern als Ausgangs- oder Endpunkt generieren
* **Video Fortsetzung** — Vom letzten Frame eines vorhandenen Videos fortfahren
* **Verschiedene Bildverhältnisse** — Unterstützung für 16:9, 9:16, 1:1 und andere Verhältnisse
* **Bildverbesserung** — Optionale visuelle Qualitätsverbesserungsfunktion
* **Aufgabenabfrage** — Überwachung des Generierungsfortschritts und Abruf von Ergebnissen

## Vorbereitungen

Vor der Nutzung musst du ein XHuoAPI API Token erhalten:

1. Registriere dich oder melde dich bei der [XHuoAPI Plattform](https://api.xhuoapi.ai) an
2. Gehe zur Seite [Luma Videos API](https://api.xhuoapi.ai/documents/luma-videos)
3. Klicke auf „Acquire“, um ein API Token zu erhalten (bei der ersten Anfrage wird ein kostenloses Kontingent gewährt)

## Installation und Konfiguration

### Methode 1: pip Installation (empfohlen)

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

### Methode 2: Quellcodeinstallation

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

Nach der Installation kannst du den Dienst mit dem Befehl `mcp-luma` starten.

## Verwendung in Claude Desktop

Bearbeite die Konfigurationsdatei von Claude Desktop:

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

Füge die folgende Konfiguration hinzu:

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

Wenn du `uvx` verwendest (keine vorherige Paketinstallation erforderlich):

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

Speichere die Konfiguration und starte Claude Desktop neu, um die Luma-Tools im Gespräch zu verwenden.

## Verwendung in VS Code / Cursor

Erstelle im Stammverzeichnis des Projekts die Datei `.vscode/mcp.json`:

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

Oder verwende `uvx`:

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

## Verfügbare Werkzeugliste

| Werkzeugname                     | Beschreibung                               |
| -------------------------------- | ------------------------------------------ |
| `luma_generate_video`            | Videos aus Textaufforderungen generieren   |
| `luma_generate_video_from_image` | Videos aus Bildern generieren              |
| `luma_extend_video`              | Fortsetzung eines vorhandenen Videos       |
| `luma_extend_video_from_url`     | Fortsetzung eines Videos von einer URL     |
| `luma_get_task`                  | Abfrage des Status einer einzelnen Aufgabe |
| `luma_get_tasks_batch`           | Batchabfrage des Status von Aufgaben       |

## Nutzung Beispiele

Nach der Konfiguration kannst du diese Funktionen direkt in der AI-Client-Anwendung mit natürlicher Sprache aufrufen, zum Beispiel:

* „Hilf mir, ein Video von einem Sonnenuntergang am Meer zu generieren“
* „Verwende dieses Foto als ersten Frame und generiere ein 5-sekündiges Video“
* „Setze dieses Video fort und verlängere es um einen Abschnitt“
* „Generiere ein Hochformatvideo im Verhältnis 9:16“

## Weitere Informationen

* GitHub Repository: [XHuoAPI/LumaMCP](https://github.com/XHuoAPI/LumaMCP)
* PyPI Paket: [mcp-luma](https://pypi.org/project/mcp-luma/)
* API Dokumentation: [Luma Video Generierungs API](https://api.xhuoapi.ai/documents/luma)