> ## 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 інтеграційний посібник

> luma MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) — це протокол контексту моделі, розроблений компанією Anthropic, який дозволяє AI моделям (таким як Claude, GPT тощо) викликати зовнішні інструменти через стандартизований інтерфейс. Завдяки Luma MCP Server, наданому XHuoAPI, ви можете безпосередньо генерувати AI відео в таких AI клієнтах, як Claude Desktop, VS Code, Cursor тощо.

## Огляд функцій

Luma MCP Server надає такі основні функції:

* **Генерація відео з тексту** — створення відео високої якості за допомогою текстових підказок
* **Генерація відео з зображення** — створення відео на основі зображення
* **Продовження відео** — продовження генерації з останнього кадру існуючого відео
* **Різні співвідношення сторін** — підтримка 16:9, 9:16, 1:1 та інших співвідношень
* **Покращення зображення** — необов'язкова функція покращення візуальної якості
* **Запит завдань** — моніторинг прогресу генерації та отримання результатів

## Попередня підготовка

Перед використанням вам потрібно отримати XHuoAPI API Token:

1. Зареєструйтесь або увійдіть на [платформу XHuoAPI](https://api.xhuoapi.ai)
2. Перейдіть на сторінку [Luma Videos API](https://api.xhuoapi.ai/documents/luma-videos)
3. Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

## Встановлення та налаштування

### Спосіб перший: установка через pip (рекомендується)

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

### Спосіб другий: установка з вихідного коду

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

Після завершення установки ви можете використовувати команду `mcp-luma` для запуску сервісу.

## Використання в Claude Desktop

Редагуйте конфігураційний файл Claude Desktop:

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

Додайте наступну конфігурацію:

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

Якщо ви використовуєте `uvx` (не потрібно попередньо встановлювати пакет):

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

Збережіть конфігурацію та перезапустіть Claude Desktop, щоб використовувати інструменти Luma в діалозі.

## Використання в VS Code / Cursor

У кореневій директорії проекту створіть `.vscode/mcp.json`:

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

Або використовуйте `uvx`:

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

## Список доступних інструментів

| Назва інструменту                | Опис                                 |
| -------------------------------- | ------------------------------------ |
| `luma_generate_video`            | Генерація відео з текстових підказок |
| `luma_generate_video_from_image` | Генерація відео з зображення         |
| `luma_extend_video`              | Продовження існуючого відео          |
| `luma_extend_video_from_url`     | Продовження відео з вказаного URL    |
| `luma_get_task`                  | Запит стану одного завдання          |
| `luma_get_tasks_batch`           | Пакетний запит стану завдань         |

## Приклади використання

Після налаштування ви можете безпосередньо використовувати ці функції в AI клієнті природною мовою, наприклад:

* «Допоможіть мені згенерувати відео заходу сонця на березі моря»
* «Використайте це зображення як перший кадр, щоб згенерувати 5-секундне відео»
* «Продовжте це відео, додавши ще один фрагмент»
* «Згенеруйте вертикальне відео зі співвідношенням 9:16»

## Додаткова інформація

* Репозиторій GitHub: [XHuoAPI/LumaMCP](https://github.com/XHuoAPI/LumaMCP)
* Пакет PyPI: [mcp-luma](https://pypi.org/project/mcp-luma/)
* Документація API: [Luma відео генерація API](https://api.xhuoapi.ai/documents/luma)