seedance-polza-mcp-server

Seedance Polza MCP 服务

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

通过 Polza.ai 使用 bytedance/seedance-2（及其他 Seedance 模型）生成视频的 MCP 服务。

功能

• 文本生成视频和图片生成视频
• 读取生成状态
• 持续轮询，直到视频就绪
• 返回精简结果（id、状态、url、usage、warnings）

安装要求

• Claude Desktop 或 Claude Code
• uv
• Python 3.11+
• POLZA_AI_API_KEY — 可在 polza.ai/dashboard/api-keys 获取密钥

安装 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 等待视频就绪。

工具

• seedance_create_video — 启动生成
• seedance_get_status — 根据 id 检查状态
• seedance_wait_for_completion — 持续轮询，直到就绪
• seedance_model_guide — 参数简要指南

默认值

• 模型：bytedance/seedance-2
• 轮询间隔：8 秒
• 最大等待时间：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 — 图片生成视频的参考图
• videos — 视频生成视频的参考视频
• 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

重要说明

此服务不会运行实时预览，也不会自行消耗令牌。
只有在明确调用工具时，才会启动生成。

许可证

MIT。