Seedance MCP 接続ガイド

MCP（Model Context Protocol）は Anthropic によって開発されたモデルコンテキストプロトコルで、Claude や GPT などの AI モデルが標準化されたインターフェースを通じて外部ツールを呼び出すことを可能にします。AceData Cloud が提供する Seedance MCP Server を利用することで、Claude Desktop、VS Code、Cursor などの AI クライアント上で直接 ByteDance の Seedance による AI 動画生成を利用できます。

機能概要

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 トークンを取得してください：

AceData Cloud プラットフォームに登録またはログイン
Seedance Videos API ページへ移動
「Acquire」をクリックして API トークンを取得（初回申請時は無料クレジット付与）

インストールと設定

方法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トークン"
      }
    }
  }
}

uvx を使用する場合（事前にパッケージをインストール不要）：

{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

設定保存後、Claude Desktop を再起動すると Seedance 関連ツールを会話内で利用可能になります。

VS Code / Cursor での使用方法

プロジェクトルートに .vscode/mcp.json を作成：

{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

または uvx を使用する場合：

{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

利用可能なツール一覧

ツール名	説明
`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 モデルで音声付き動画を生成して」

追加情報

GitHub リポジトリ：AceDataCloud/MCPSeedance
PyPI パッケージ：mcp-seedance
API ドキュメント：Seedance 動画生成 API

MCP サーバー

​機能概要

​事前準備

​インストールと設定

​方法1：pip インストール（推奨）

​方法2：ソースコードからインストール

​Claude Desktop での使用方法

​VS Code / Cursor での使用方法

​利用可能なツール一覧

​使用例

​追加情報