Przejdź do głównej treści

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) 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
  2. Przejdź do strony Luma Videos API
  3. Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

​
Instalacja i konfiguracja

​
Metoda 1: instalacja pip (zalecana)

pip install mcp-luma

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

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ę: 
{
  "mcpServers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
Jeśli używasz uvx (nie wymaga wcześniejszej instalacji pakietu): 
{
  "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: 
{
  "servers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
Lub użyj uvx: 
{
  "servers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}

​
Lista dostępnych narzędzi

Nazwa narzędziaOpis
luma_generate_videoGenerowanie wideo na podstawie tekstowych podpowiedzi
luma_generate_video_from_imageGenerowanie wideo z obrazu
luma_extend_videoDopisywanie do istniejącego wideo
luma_extend_video_from_urlDopisywanie do wideo określonego przez URL
luma_get_taskZapytanie o status pojedynczego zadania
luma_get_tasks_batchMasowe 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