Перейти до основного вмісту
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:
  1. Зареєструйтесь або увійдіть на AceData Cloud платформу
  2. Перейдіть на сторінку Seedance Videos API
  3. Натисніть «Acquire», щоб отримати API Token (при першому запиті надається безкоштовний ліміт)

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

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

pip install mcp-seedance

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

git clone https://github.com/AceDataCloud/MCPSeedance.git
cd MCPSeedance
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»

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