{
  "markdown": "# Seedance Polza MCP Server\n\n`mcp-name: io.github.ivanantigravity-lgtm/seedance-polza-mcp-server`\n\nMCP сервер для генерации видео через `bytedance/seedance-2` (и другие Seedance-модели) на Polza.ai.\n\n## Что умеет\n\n- text-to-video и image-to-video генерация\n- чтение статуса генерации\n- polling до готовности видео\n- возвращает компактный результат (id, статус, url, usage, warnings)\n\n## Что нужно для установки\n\n- `Claude Desktop` или `Claude Code`\n- [`uv`](https://docs.astral.sh/uv/)\n- Python 3.11+\n- `POLZA_AI_API_KEY` — ключ берётся на [polza.ai/dashboard/api-keys](https://polza.ai/dashboard/api-keys)\n\nПоставить `uv`:\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n## Установка за 2 минуты (через PyPI + uvx)\n\n### Claude Code / VS Code\n\nСоздай `.mcp.json` в корне проекта:\n\n```json\n{\n  \"mcpServers\": {\n    \"seedance-polza\": {\n      \"command\": \"uvx\",\n      \"args\": [\"seedance-polza-mcp-server@latest\"],\n      \"env\": {\n        \"POLZA_AI_API_KEY\": \"your-polza-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nПерезапусти Claude Code.\n\n### Claude Desktop (macOS)\n\nФайл `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"seedance-polza\": {\n      \"command\": \"uvx\",\n      \"args\": [\"seedance-polza-mcp-server@latest\"],\n      \"env\": {\n        \"POLZA_AI_API_KEY\": \"your-polza-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop (Windows)\n\nФайл: `%APPDATA%\\Claude\\claude_desktop_config.json`. Содержимое идентичное.\n\n## Как проверить, что работает\n\nПосле перезапуска Claude попроси:\n\n> Сделай через seedance короткое видео: закат над океаном, 16:9, 5 секунд\n\nClaude должен вызвать `seedance_create_video` и дождаться готовности через `seedance_wait_for_completion`.\n\n## Tools\n\n- `seedance_create_video` — запустить генерацию\n- `seedance_get_status` — проверить статус по `id`\n- `seedance_wait_for_completion` — ждать polling-ом до готовности\n- `seedance_model_guide` — краткая памятка по параметрам\n\n## Дефолты\n\n- модель: `bytedance/seedance-2`\n- polling interval: `8` секунд\n- max wait: `900` секунд\n\n## Переменные окружения\n\n| Переменная | Обязательная | По умолчанию |\n| --- | --- | --- |\n| `POLZA_AI_API_KEY` | да | — |\n| `POLZA_BASE_URL` | нет | `https://polza.ai/api/v1` |\n| `SEEDANCE_MODEL` | нет | `bytedance/seedance-2` |\n| `SEEDANCE_POLL_INTERVAL` | нет | `8` |\n| `SEEDANCE_MAX_WAIT` | нет | `900` |\n| `LOG_LEVEL` | нет | `INFO` |\n\n## Поддерживаемые входные параметры\n\nБазовые параметры под видео:\n\n- `prompt`\n- `aspect_ratio` (`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9` и т.д.)\n- `resolution` (`480p`, `720p`, `1080p`)\n- `duration` (`5s`, `10s`, `15s` — зависит от модели)\n- `images` — референсы для image-to-video\n- `videos` — референсы для video-to-video\n- `seed`\n- `async`\n- `user`\n\nФормат `images` / `videos`:\n\n```json\n{ \"type\": \"url\", \"data\": \"https://example.com/file.png\" }\n```\n\nили\n\n```json\n{ \"type\": \"base64\", \"data\": \"data:image/png;base64,...\" }\n```\n\n## Что возвращает сервер\n\nСервер не делает лишней магии. Он возвращает:\n\n- `id` генерации\n- `status`\n- `model`\n- `usage` (в том числе `cost_rub`)\n- `url` результата, если видео готово\n- `warnings` / `error` при проблемах\n\n## Локальная разработка\n\n```bash\ngit clone https://github.com/ivanantigravity-lgtm/seedance-polza-mcp-server.git\ncd seedance-polza-mcp-server\nuv sync\nPOLZA_AI_API_KEY=your_key uv run python -m seedance_polza_mcp_server.server\n```\n\n## Важно\n\nЭтот сервер не гоняет live preview и не тратит токены сам по себе.  \nГенерация запускается только по явному вызову tool.\n\n## Лицензия\n\nMIT.\n",
  "bytes": 3533,
  "sha": "de799ce4ddabfc19a0e07bcd5afee1e5b5406be6944be02ce517959025237f64",
  "repo_slug": "ivanantigravity-lgtm/seedance-polza-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ivanantigravity_lgtm_seedance__6b2a20e6/readme"
}