> ## 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 Przewodnik po integracji

> luma MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) to protokół kontekstu modelu wprowadzony przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi za pomocą znormalizowanego interfejsu. Dzięki Luma MCP Server dostarczonemu przez XHuoAPI, możesz bezpośrednio generować filmy AI w klientach AI, takich jak Claude Desktop, VS Code, Cursor itp.

## Przegląd funkcji

Luma MCP Server oferuje następujące kluczowe funkcje:

* **Generowanie wideo z tekstu** — generowanie wysokiej jakości wideo na podstawie tekstowych podpowiedzi
* **Generowanie wideo z obrazu** — generowanie wideo na podstawie obrazu jako punktu wyjścia lub końca
* **Dopisywanie wideo** — kontynuowanie generowania z ostatniej klatki istniejącego wideo
* **Różne proporcje obrazu** — wsparcie dla proporcji 16:9, 9:16, 1:1 i innych
* **Wzmacnianie obrazu** — opcjonalna funkcja poprawy jakości wizualnej
* **Zapytania o zadania** — monitorowanie postępu generowania i uzyskiwanie wyników

## Wymagania wstępne

Przed użyciem musisz uzyskać token API XHuoAPI:

1. Zarejestruj się lub zaloguj na [platformie XHuoAPI](https://api.xhuoapi.ai)
2. Przejdź do strony [Luma Videos API](https://api.xhuoapi.ai/documents/luma-videos)
3. Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

## Instalacja i konfiguracja

### Metoda 1: instalacja pip (zalecana)

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

### Metoda 2: instalacja ze źródła

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

Po zakończeniu instalacji możesz uruchomić serwis za pomocą polecenia `mcp-luma`.

## Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:

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

Dodaj następującą konfigurację:

```json theme={null}
{
  "mcpServers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Jeśli używasz `uvx` (nie wymaga wcześniejszej instalacji pakietu):

```json theme={null}
{
  "mcpServers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Po zapisaniu konfiguracji uruchom ponownie Claude Desktop, aby móc korzystać z narzędzi związanych z Luma w rozmowie.

## Użycie w VS Code / Cursor

Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:

```json theme={null}
{
  "servers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Lub użyj `uvx`:

```json theme={null}
{
  "servers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

## Lista dostępnych narzędzi

| Nazwa narzędzia                  | Opis                                                  |
| -------------------------------- | ----------------------------------------------------- |
| `luma_generate_video`            | Generowanie wideo na podstawie tekstowych podpowiedzi |
| `luma_generate_video_from_image` | Generowanie wideo z obrazu                            |
| `luma_extend_video`              | Dopisywanie do istniejącego wideo                     |
| `luma_extend_video_from_url`     | Dopisywanie do wideo określonego przez URL            |
| `luma_get_task`                  | Zapytanie o status pojedynczego zadania               |
| `luma_get_tasks_batch`           | Masowe zapytanie o status zadań                       |

## Przykłady użycia

Po skonfigurowaniu możesz bezpośrednio wywoływać te funkcje w kliencie AI za pomocą naturalnego języka, na przykład:

* „Pomóż mi wygenerować film o zachodzie słońca nad morzem”
* „Użyj tego zdjęcia jako pierwszej klatki, aby wygenerować 5-sekundowe wideo”
* „Dopisz do tego wideo, przedłużając je”
* „Wygeneruj wideo w pionie, proporcja 9:16”

## Więcej informacji

* Repozytorium GitHub: [XHuoAPI/LumaMCP](https://github.com/XHuoAPI/LumaMCP)
* Pakiet PyPI: [mcp-luma](https://pypi.org/project/mcp-luma/)
* Dokumentacja API: [API do generowania wideo Luma](https://api.xhuoapi.ai/documents/luma)