Seedance MCP Керівництво з інтеграції

MCP (Model Context Protocol) — це протокол контексту моделі, розроблений Anthropic, який дозволяє AI-моделям (наприклад, Claude, GPT тощо) викликати зовнішні інструменти через стандартизований інтерфейс. За допомогою Seedance MCP Server від AceData Cloud ви можете безпосередньо використовувати Seedance від ByteDance для генерації AI-відео у клієнтах AI, таких як Claude Desktop, VS Code, Cursor тощо.

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

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

Генерація відео з тексту — створення високоякісних відео за текстовими підказками
Генерація відео з зображень — створення відео з використанням зображень як референсів (перший кадр, останній кадр, режим референсного зображення тощо)
Підтримка кількох моделей — підтримка моделей Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite та інших
Різні роздільні здатності — підтримка 480p, 720p, 1080p
Різні співвідношення сторін — підтримка 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 тощо
Гнучка тривалість — підтримка відео тривалістю від 2 до 12 секунд
Генерація аудіо — деякі моделі підтримують одночасну генерацію аудіо
Моніторинг завдань — відстеження прогресу генерації та отримання результатів

Попередні вимоги

Перед використанням необхідно отримати AceData Cloud API Token:

Зареєструйтесь або увійдіть на AceData Cloud платформу
Перейдіть на сторінку Seedance Videos API
Натисніть «Acquire», щоб отримати API Token (при першому запиті надається безкоштовний ліміт)

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

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

pip install mcp-seedance

Спосіб 2: Встановлення з вихідного коду

git clone https://github.com/AceDataCloud/SeedanceMCP.git
cd SeedanceMCP
pip install -e .

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

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

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

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

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

{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}

Якщо використовуєте uvx (без необхідності попередньої установки пакетів):

{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}

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

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

Створіть у корені проекту файл .vscode/mcp.json:

{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}

Або з uvx:

{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}

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

Назва інструменту	Опис
`seedance_generate_video`	Генерація відео за текстовими підказками
`seedance_generate_video_from_image`	Генерація відео з використанням зображення
`seedance_get_task`	Перевірка статусу одного завдання
`seedance_get_tasks_batch`	Масова перевірка статусу завдань
`seedance_list_models`	Перелік усіх доступних моделей та їх можливостей
`seedance_list_resolutions`	Перелік доступних роздільних здатностей і співвідношень сторін
`seedance_list_actions`	Перелік усіх доступних інструментів та прикладів робочих процесів

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

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

«Зроби, будь ласка, таймлапс відео міських вулиць за допомогою Seedance»
«Зроби 8-секундне відео, використовуючи цю фотографію як перший кадр»
«Згенеруй коротке відео 1080p у вертикальному форматі 9:16»
«Згенеруй відео з аудіо за допомогою моделі Seedance 1.5 Pro»

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

Репозиторій GitHub: AceDataCloud/SeedanceMCP
Пакет PyPI: mcp-seedance
Документація API: Seedance Відео Генерація API

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

​Попередні вимоги

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

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

​Спосіб 2: Встановлення з вихідного коду

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

​Використання у VS Code / Cursor

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

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

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