Luma MCP Przewodnik po integracji

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 AceData Cloud, 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 AceData Cloud:

Zarejestruj się lub zaloguj na platformie AceData Cloud
Przejdź do strony Luma Videos API
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/AceDataCloud/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": {
        "ACEDATACLOUD_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": {
        "ACEDATACLOUD_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": {
        "ACEDATACLOUD_API_TOKEN": "Twój token API"
      }
    }
  }
}

Lub użyj uvx:

{
  "servers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "ACEDATACLOUD_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: AceDataCloud/LumaMCP
Pakiet PyPI: mcp-luma
Dokumentacja API: API do generowania wideo Luma

​Przegląd funkcji

​Wymagania wstępne

​Instalacja i konfiguracja

​Metoda 1: instalacja pip (zalecana)

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

​Użycie w Claude Desktop

​Użycie w VS Code / Cursor

​Lista dostępnych narzędzi

​Przykłady użycia

​Więcej informacji