mcpField
S
seedance-polza-mcp-server

seedance-polza-mcp-server

Local
github.com/ivanantigravity-lgtmMedia & Design1Updated 27w ago
Repository

About seedance-polza-mcp-server

An MCP server for generating videos with Seedance models through Polza.ai. It supports text-to-video and image-to-video, and provides status checks and polling until a result is ready.

Key features

  1. 01Generate videos from text prompts
  2. 02Generate videos from reference images
  3. 03Check generation status
  4. 04Poll until video completion
  5. 05Set aspect ratio, resolution, and duration
  6. 06Return result URL and usage details

Use cases

  1. 01Create a video from a written description
  2. 02Animate reference images into video
  3. 03Track a video job until its result is ready

MCP support

Exposes tools to create videos, check their status, wait for completion, and consult a model guide. Results include generation ID, status, model, usage, and a URL when the video is ready.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ivanantigravity-lgtm-seedance-polza": {
      "command": "uvx",
      "args": [
        "seedance-polza-mcp-server"
      ]
    }
  }
}
Run commanduvx seedance-polza-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiseedance-polza-mcp-server0.1.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Seedance Polza MCP Server

mcp-name: io.github.ivanantigravity-lgtm/seedance-polza-mcp-server

MCP сервер для генерации видео через bytedance/seedance-2 (и другие Seedance-модели) на Polza.ai.

Что умеет

  • text-to-video и image-to-video генерация
  • чтение статуса генерации
  • polling до готовности видео
  • возвращает компактный результат (id, статус, url, usage, warnings)

Что нужно для установки

Поставить uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Установка за 2 минуты (через PyPI + uvx)

Claude Code / VS Code

Создай .mcp.json в корне проекта:

{
  "mcpServers": {
    "seedance-polza": {
      "command": "uvx",
      "args": ["seedance-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

Перезапусти Claude Code.

Claude Desktop (macOS)

Файл ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "seedance-polza": {
      "command": "uvx",
      "args": ["seedance-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}
Claude Desktop (Windows)

Файл: %APPDATA%\Claude\claude_desktop_config.json. Содержимое идентичное.

Как проверить, что работает

После перезапуска Claude попроси:

Сделай через seedance короткое видео: закат над океаном, 16:9, 5 секунд

Claude должен вызвать seedance_create_video и дождаться готовности через seedance_wait_for_completion.

Tools

  • seedance_create_video — запустить генерацию
  • seedance_get_status — проверить статус по id
  • seedance_wait_for_completion — ждать polling-ом до готовности
  • seedance_model_guide — краткая памятка по параметрам

Дефолты

  • модель: bytedance/seedance-2
  • polling interval: 8 секунд
  • max wait: 900 секунд

Переменные окружения

ПеременнаяОбязательнаяПо умолчанию
POLZA_AI_API_KEYда—
POLZA_BASE_URLнетhttps://polza.ai/api/v1
SEEDANCE_MODELнетbytedance/seedance-2
SEEDANCE_POLL_INTERVALнет8
SEEDANCE_MAX_WAITнет900
LOG_LEVELнетINFO

Поддерживаемые входные параметры

Базовые параметры под видео:

  • prompt
  • aspect_ratio (16:9, 9:16, 1:1, 4:3, 3:4, 21:9 и т.д.)
  • resolution (480p, 720p, 1080p)
  • duration (5s, 10s, 15s — зависит от модели)
  • images — референсы для image-to-video
  • videos — референсы для video-to-video
  • seed
  • async
  • user

Формат images / videos:

{ "type": "url", "data": "https://example.com/file.png" }

или

{ "type": "base64", "data": "data:image/png;base64,..." }

Что возвращает сервер

Сервер не делает лишней магии. Он возвращает:

  • id генерации
  • status
  • model
  • usage (в том числе cost_rub)
  • url результата, если видео готово
  • warnings / error при проблемах

Локальная разработка

git clone https://github.com/ivanantigravity-lgtm/seedance-polza-mcp-server.git
cd seedance-polza-mcp-server
uv sync
POLZA_AI_API_KEY=your_key uv run python -m seedance_polza_mcp_server.server

Важно

Этот сервер не гоняет live preview и не тратит токены сам по себе.
Генерация запускается только по явному вызову tool.

Лицензия

MIT.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.