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、使用量、警告）を返す

インストールに必要なもの

• 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。