Перейти к основному содержанию
MCP (Model Context Protocol) — это протокол контекста модели, разработанный компанией Anthropic, который позволяет AI моделям (таким как Claude, GPT и др.) вызывать внешние инструменты через стандартизированный интерфейс. С помощью Luma MCP Server, предоставляемого AceData Cloud, вы можете напрямую генерировать AI видео в таких AI клиентах, как Claude Desktop, VS Code, Cursor и др.

​
Обзор функций

Luma MCP Server предоставляет следующие основные функции:
  • Генерация видео из текста — создание высококачественного видео на основе текстовых подсказок
  • Генерация видео из изображения — создание видео на основе изображения в качестве начальной или конечной точки
  • Продолжение видео — продолжение генерации от последнего кадра существующего видео
  • Разные соотношения сторон — поддержка различных соотношений, таких как 16:9, 9:16, 1:1 и др.
  • Улучшение изображения — опциональная функция повышения визуального качества
  • Запрос задач — мониторинг прогресса генерации и получение результатов

​
Предварительная подготовка

Перед использованием вам необходимо получить AceData Cloud API Token:
  1. Зарегистрируйтесь или войдите на платформу AceData Cloud
  2. Перейдите на страницу Luma Videos API
  3. Нажмите «Acquire», чтобы получить API Token (при первом запросе предоставляется бесплатный лимит)

​
Установка и настройка

​
Способ 1: установка через pip (рекомендуется)

pip install mcp-luma

​
Способ 2: установка из исходного кода

git clone https://github.com/AceDataCloud/MCPLuma.git
cd MCPLuma
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
Добавьте следующую конфигурацию: 
{
  "mcpServers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}
Если вы используете uvx (не требует предварительной установки пакета): 
{
  "mcpServers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}
Сохраните конфигурацию и перезапустите Claude Desktop, чтобы использовать инструменты Luma в диалоге.

​
Использование в VS Code / Cursor

Создайте файл .vscode/mcp.json в корневом каталоге проекта: 
{
  "servers": {
    "luma": {
      "command": "mcp-luma",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}
Или используйте uvx: 
{
  "servers": {
    "luma": {
      "command": "uvx",
      "args": ["mcp-luma"],
      "env": {
        "ACEDATACLOUD_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»

​
Дополнительная информация