Seedance by Ace Data Cloud

Ace Data Cloud の Seedance

簡体字中国語のインストールと初回利用ガイド

AceDataCloud APIを通じてByteDance Seedanceを使用したAI動画生成を行う、Model Context Protocol（MCP）サーバーです。

Claude、VS Code、またはMCP互換クライアントから直接AI動画を生成できます。

Glama で Seedance を使う

Ace が提供するSeedance のソース掲載ページまたはリモートコネクターをご覧ください。Glama のインストール、API トークン、初回利用ガイドに従ってください。公開ディレクトリでの確認と、個人アカウントでの接続成功は別々の確認事項です。生成には Ace アカウントの残高を使用します。

goose で Seedance を使う

独立した Seedance by Ace Data Cloud ネイティブ goose プラグインをご利用ください：インストールと API トークンのガイド · 簡体字中国語。このプラグインは本 MCP サーバーを再利用しますが、goose Marketplace への掲載やデフォルトプロバイダーへの追加を意味するものではありません。

公式 MCP Registry で Seedance 統合を見つける

公式 MCP Registry の Seedanceを開き、一致する io.github.AceDataCloud エントリーを展開して、MCP カタログを利用するクライアントで Packages または Remotes のインストール情報を使用してください。これは Ace Data Cloud が提供する Seedance 統合であり、モデル提供元による推奨を意味するものではありません。Registry はディレクトリであり、ツールを実行するアプリではありません。

正確なエントリーを見つけるには、mcp-seedance（または io.github.AceDataCloud/mcp-seedance）を検索してください。公式 Registry の検索では、現在、サーバー名が照合されます。表示タイトルにスペースがあっても、検索エイリアスが追加されるわけではありません。クライアントがカタログを利用しない場合は、以下のクライアント別接続手順を使用し、トークン、サービス権限、残高、現在の価格について Applications → General application を確認してください。非同期の結果を確認する際は、元のタスク ID を保持してください。

接続：ホスト型 OAuth、API トークン、またはローカル stdio

ホスト型エンドポイントは https://seedance.mcp.acedata.cloud/mcp です。MCP クライアントで次のいずれかの方法を選択してください。

方法	使用する場面	認証情報の設定
ホスト型 OAuth	クライアントがリモート MCP OAuth に対応している場合	URL のみを追加し、AceDataCloud にサインインしてアクセスを承認します。クライアント設定にトークンを貼り付ける必要はありません。
ホスト型 API トークン	クライアントで OAuth を完了できない場合、または明示的な連携用認証情報が必要な場合	Authorization: Bearer … ヘッダーで AceDataCloud API トークンを送信します。ローカルのシークレットストアまたは環境変数に保存してください。
ローカル stdio	クライアントがローカル MCP プロセスを実行する場合	mcp-seedance をインストールし、ACEDATACLOUD_API_TOKEN をそのプロセスに渡します。この方法でも AceDataCloud API を呼び出します。

ホスト型サービスは OAuth メタデータと Dynamic Client Registration（DCR）を公開しています。DCR はクライアントアプリケーションを登録するものであり、API キーではありません。 OAuth でサインインすると、クライアントは発行された Bearer トークンを送信します。アカウントの API 認証情報が再利用または作成される場合があります。ブラウザーでサインインするには、AceDataCloud アカウントが必要です。ホスト型サービスには従量課金が適用される場合があります。実際に操作する前に、現行のサービスドキュメントと表示される料金を確認してください。同じサーバーに OAuth ログインと固定の Authorization ヘッダーを両方設定しないでください。

ホスト型 OAuth の例

• Claude および Claude Desktop のチャット： Customize → Connectors → Add custom connector でリモートのカスタムコネクターを追加し、https://seedance.mcp.acedata.cloud/mcp を入力してサインインを選択します。Claude から OAuth クライアントの登録方法を尋ねられた場合は、Register automatically を選択します。アクセス許可の確認を完了してください。Claude Desktop のローカル claude_desktop_config.json は別の設定です。Claude コネクターガイド。
• Claude Code： claude mcp add --transport http --scope user seedance https://seedance.mcp.acedata.cloud/mcp を実行し、続けて claude mcp login seedance を実行します。/mcp で確認してください。Claude Code MCP ガイド。
• Cursor： https://seedance.mcp.acedata.cloud/mcp のみを指定してリモートサーバーを追加します。プロジェクトで使用する場合は、以下のエントリーを <project>/.cursor/mcp.json に統合します。個人用の場合は、~/.cursor/mcp.json を使用します。Cursor MCP ガイド。
• VS Code / Copilot： MCP: Add Server を実行し、HTTP を選択して https://seedance.mcp.acedata.cloud/mcp を入力した後、ブラウザーでのサインインを完了します。新しいポータブルなワークスペース設定では <project>/.mcp.json を使用します。以下の VS Code 固有の形式では、<project>/.vscode/mcp.json またはユーザープロファイルを使用します。MCP: List Servers で確認してください。VS Code MCP の設定。
• Codex： codex mcp add seedance --url https://seedance.mcp.acedata.cloud/mcp を実行し、続けて codex mcp login seedance を実行します。ユーザー設定は ~/.codex/config.toml にあります。Codex 公式 MCP ガイド。

Cursor のプロジェクト設定（OAuth）：

{
  "mcpServers": {
    "seedance": {"url": "https://seedance.mcp.acedata.cloud/mcp"}
  }
}

VS Code 固有のワークスペース設定（OAuth）：

{
  "servers": {
    "seedance": {"type": "http", "url": "https://seedance.mcp.acedata.cloud/mcp"}
  }
}

ホステッド API トークン

1. Ace Data Cloud → Applicationsを開きます。サインインするか、先にアカウントを登録します。
2. General applicationを探します。まだ作成されていない場合は、Initialize General Applicationを選択します。一般キーではアカウントで利用可能なサービスを使用できますが、専用アプリケーションのキーはそのサービスに限定されます。必要なサービス／モデルへのアクセス権と現在の料金を確認します。
3. アプリケーションカードからAPI Keyをコピーするか、Keys / Manage Keys → Createを開き、この連携用の別のキーを作成します。個別に無効化またはローテーションできるよう、用途がわかる名前を付けます。
4. キーを作成する際は、Expiration Time、Set Usage Limitation、Allowed APIsを確認します。必要な制限のみを有効にし、呼び出す操作を許可してから、Createをクリックし、キー一覧からトークンをコピーします。タスクの参照権限があっても、生成を送信する権限が付与されるわけではありません。最初のリクエストを実行できる残高がアプリケーションにあることを確認します。トライアル利用枠がある場合、その内容は現在アカウントに表示されているものに従います。
5. 引用符、空白、Bearer を含めず、トークンの値だけをコピーします。API Key／API Tokenフィールドには、この生の値を入力します。手動で設定するHTTPのAuthorizationヘッダーに限り、Bearer プレフィックスが必要です。platform-...形式のアカウント管理トークンは、生成APIキーの代わりにはなりません。

キーは、クライアントの認証情報ストア、または以下に示す環境変数に保存します。プロンプト、共有ワークフロー、スクリーンショット、Gitコミットには絶対に含めないでください。認証に失敗した場合は、別のキーを作成する前に、コピーした値全体、アプリケーション／サービスへのアクセス権、有効期限、使用制限、残高を確認します。

固定のBearerヘッダーはOAuthを迂回します。ヘッダーが無効な場合は、ブラウザーでのサインインを試す前に削除してください。保存済みの認証情報は非公開にしてください。

Claude Codeでは、サーバーを追加するときにシェルがトークンを展開します。保存されたユーザーMCP設定は秘密情報として扱ってください。

export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
claude mcp add --transport http --scope user seedance https://seedance.mcp.acedata.cloud/mcp \
  --header "Authorization: Bearer $ACEDATACLOUD_API_TOKEN"

Claude Codeのプロジェクト設定では、<project>/.mcp.jsonに変数参照を記述し、Claude Codeを起動する環境でその変数を設定します。

{
  "mcpServers": {
    "seedance": {
      "type": "http",
      "url": "https://seedance.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}"}
    }
  }
}

Cursorでは、~/.cursor/mcp.jsonまたはコミット対象外のプロジェクト設定で、異なる環境変数構文を使用します。

{
  "mcpServers": {
    "seedance": {
      "url": "https://seedance.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${env:ACEDATACLOUD_API_TOKEN}"}
    }
  }
}

VS Codeでは、MCP: Open User Configurationを実行し、このサーバーとマスクされた入力をマージします。${input:...}はVS Codeのユーザー／ワークスペース形式用であり、Agent Hostの.mcp.json形式との互換性はありません。

{
  "inputs": [
    {"id": "acedata-seedance-token", "type": "promptString", "description": "AceDataCloud API token", "password": true}
  ],
  "servers": {
    "seedance": {
      "type": "http",
      "url": "https://seedance.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${input:acedata-seedance-token}"}
    }
  }
}

Clineでは、MCP設定UIまたはCLIファイル~/.cline/data/settings/cline_mcp_settings.jsonを使用します。リモートトランスポートの値はstreamableHttpです。JetBrains AI Assistantでは、**Settings → Tools → AI Assistant → Model Context Protocol (MCP)**からリモートURLを追加します。Zedでは、OAuthの場合はURLのみを指定したcontext_serversエントリーを使うか、ローカルのBearerヘッダーを追加します。これらのクライアントは設定スキーマがそれぞれ異なります。他のクライアントのJSONをコピーせず、各クライアントの最新のUIに従ってください。Cline · JetBrains · Zed.

ローカル stdio

パッケージをインストールし、ローカルプロセスに API トークンを設定します。

python -m pip install mcp-seedance
export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
mcp-seedance

Claude Desktop のローカル MCP で使用する場合は、開発者設定から開いたファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）にこのエントリをマージします。uvx を使用するには、uv が PATH 上に必要です。

{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {"ACEDATACLOUD_API_TOKEN": "YOUR_API_TOKEN"}
    }
  }
}

このユーザーレベルのファイルは非公開にしてください。セルフホストの HTTP では mcp-seedance --transport http --port 8000 を使用し、適切なネットワーク制御と TLS 制御のもとでのみ公開してください。ローカルで実行しても、AceDataCloud API が呼び出されます。

プロンプトの例

最初の結果を確認する

山の上を雲が流れる短い動画を生成し、完了したタスクと最終的な動画 URL を取得してください。

これはプロンプトの例であり、実行時間や成功を保証したり、成功を記録したりするものではありません。タスク ID を保存し、タスクが最終的に成功するまで待ってから、最終メディアを確認してください。

サービスを使用する前の確認事項

1. https://seedance.mcp.acedata.cloud/health が {"status":"ok"} を返す場合、確認できるのはエンドポイントへの到達性のみです。
2. MCP クライアントがツールを読み込むことを確認します。seedance_list_models は参照用のツールであり、下流 API へのアクセスや残高は確認できません。
3. API を完全に確認する必要がある場合は、現在のサービスドキュメントと表示されている料金を確認してから、独自の有効な入力で seedance_generate_video を呼び出してください。結果にタスク ID が含まれている場合は、成功または失敗が確定するまで、同じ ID に対して seedance_get_task を呼び出してください。進行状況を確認するためだけに、操作を再送信しないでください。

401 が発生した場合は、クライアントが使用した認証経路と、トークンまたは OAuth セッションが有効かどうかを確認してください。403 は、アカウントの権限またはコンテンツモデレーションによる失敗を示している可能性があります。返されたエラーを確認してください。残高不足や下流サービスの障害については、それぞれ別途診断が必要です。ツールが一覧に表示されていることやタスクが送信されたことは、結果の成功を保証しません。

機能

• テキストから動画を生成 - テキストプロンプトから AI 生成動画を作成します
• 画像から動画を生成 - 最初のフレーム、最後のフレーム、参照画像を指定して画像をアニメーション化します
• 複数のモデル - Seedance 2.0（Fast／Mini、マルチモーダル参照を含む）、1.5 Pro、1.0 Pro、1.0 Pro Fast、1.0 Lite T2V／I2V をサポートします
• 複数の解像度 - 480p、720p（デフォルト）、1080p、4k の出力（2.5 は 1080p をサポートし、4k は doubao-seedance-2-0-260128 のみ）
• 柔軟なアスペクト比 - 16:9、9:16、1:1、4:3、3:4、21:9、アダプティブに対応します
• 音声の生成 - 動画に同期した音声を生成します（1.5 Pro および 2.0 シリーズ）
• サービスティア - デフォルト（優先）と Flex（コスト効率重視）の処理
• タスクの追跡 - 生成の進行状況を監視し、結果を取得します

ツールのリファレンス

ツール	説明
seedance_generate_video	ByteDance Seedance を使用して、テキストプロンプトから AI 動画を生成します。
seedance_generate_video_from_image	ByteDance Seedance を使用して、参照画像から AI 動画を生成します。
seedance_get_task	動画生成タスクのステータスと結果を取得します。
seedance_get_tasks_batch	複数の動画生成タスクを一度に取得します。
seedance_list_models	利用可能なすべての Seedance モデルと、その機能および料金を一覧表示します。
seedance_list_resolutions	Seedance で利用可能なすべての解像度とアスペクト比を一覧表示します。
seedance_list_actions	利用可能なすべての Seedance API アクションと対応するツールを一覧表示します。

利用可能なツール

動画生成

ツール	説明
seedance_generate_video	テキストプロンプトから動画を生成します
seedance_generate_video_from_image	参照画像／開始画像／終了画像を使用して動画を生成します

タスク

ツール	説明
seedance_get_task	単一タスクのステータスを照会します
seedance_get_tasks_batch	複数のタスクを一度に照会します

情報

ツール	説明
seedance_list_models	利用可能な Seedance モデルを一覧表示します
seedance_list_resolutions	利用可能な出力解像度を一覧表示します
seedance_list_actions	利用可能な API アクションを一覧表示します

使用例

プロンプトから動画を生成する

User: Create a video of a cat playing with a ball of yarn

Claude: I'll generate a video for you.
[Calls seedance_generate_video with prompt="A cute cat playfully batting a ball of yarn"]

画像をアニメーション化する

User: Turn this image into a video: https://example.com/landscape.jpg

Claude: I'll create a video from your image.
[Calls seedance_generate_video_from_image with first_frame_url and appropriate prompt]

音声付きで生成する

User: Create a video of rain falling with sound

Claude: I'll generate a video with synchronized audio.
[Calls seedance_generate_video with prompt="Rain falling on a quiet street" and generate_audio=True, model="doubao-seedance-1-5-pro-251215"]

利用可能なモデル

モデル	説明	機能
doubao-seedance-2-5-260628	2.5	最大 30 秒、1080p、編集／延長、マルチモーダル参照
doubao-seedance-2-0-fast-260128	2.0 Fast	最新世代、高速
doubao-seedance-2-0-mini-260615	2.0 Mini	最新世代、軽量、2.0 で最安
doubao-seedance-1-5-pro-251215	1.5 Pro	音声生成、T2V、I2V
doubao-seedance-1-0-pro-250528	1.0 Pro	高品質な T2V、I2V
doubao-seedance-1-0-pro-fast-251015	1.0 Pro Fast	より高速な生成
doubao-seedance-1-0-lite-t2v-250428	1.0 Lite T2V	軽量なテキストから動画への生成
doubao-seedance-1-0-lite-i2v-250428	1.0 Lite I2V	軽量な画像から動画への生成

利用可能なアスペクト比

アスペクト比	説明	用途
16:9	横向き（デフォルト）	YouTube、テレビ、プレゼンテーション
9:16	縦向き	TikTok、Instagram Reels
1:1	正方形	Instagram の投稿
4:3	標準	クラシックな動画形式
3:4	縦向き（標準）	縦向きコンテンツ
21:9	ウルトラワイド	映画風コンテンツ
adaptive	アダプティブ	画像から自動検出

設定

環境変数

変数	説明	デフォルト
ACEDATACLOUD_API_TOKEN	ローカル stdio の API トークン。ホスト型 OAuth／クライアントの Bearer ヘッダーは別途設定します	ローカル stdio で必須
ACEDATACLOUD_API_BASE_URL	API ベース URL	https://api.acedata.cloud
ACEDATACLOUD_OAUTH_CLIENT_ID	OAuth クライアント ID（ホスト型モード）	—
ACEDATACLOUD_PLATFORM_BASE_URL	プラットフォームのベース URL	https://platform.acedata.cloud
SEEDANCE_DEFAULT_MODEL	デフォルトのモデル	doubao-seedance-2-0-260128
SEEDANCE_DEFAULT_RESOLUTION	デフォルトの解像度	720p
SEEDANCE_DEFAULT_RATIO	デフォルトのアスペクト比	16:9
SEEDANCE_DEFAULT_DURATION	デフォルトの長さ（秒）	5
SEEDANCE_REQUEST_TIMEOUT	リクエストのタイムアウト（秒）	1800
LOG_LEVEL	ログレベル	INFO

コマンドラインオプション

mcp-seedance --help

Options:
  --version          Show version
  --transport        Transport mode: stdio (default) or http
  --port             Port for HTTP transport (default: 8000)

開発

開発環境のセットアップ

# Clone repository
git clone https://github.com/AceDataCloud/SeedanceMCP.git
cd SeedanceMCP

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows

# Install with dev dependencies
pip install -e ".[dev,test]"

テストの実行

# Run unit tests
pytest

# Run with coverage
pytest --cov=core --cov=tools

# Run integration tests (requires API token)
pytest tests/test_integration.py -m integration

コード品質

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy core tools

ビルドと公開

# Install build dependencies
pip install -e ".[release]"

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

プロジェクト構成

SeedanceMCP/
├── core/                   # Core modules
│   ├── __init__.py
│   ├── client.py          # HTTP client for Seedance API
│   ├── config.py          # Configuration management
│   ├── exceptions.py      # Custom exceptions
│   ├── server.py          # MCP server initialization
│   ├── types.py           # Type definitions
│   └── utils.py           # Utility functions
├── tools/                  # MCP tool definitions
│   ├── __init__.py
│   ├── video_tools.py     # Video generation tools
│   ├── task_tools.py      # Task query tools
│   └── info_tools.py      # Information tools
├── prompts/                # MCP prompts
│   └── __init__.py        # Prompt templates
├── tests/                  # Test suite
│   ├── conftest.py
│   ├── test_client.py
│   ├── test_config.py
│   ├── test_integration.py
│   └── test_utils.py
├── deploy/                 # Deployment configs
│   └── production/
│       ├── deployment.yaml
│       ├── ingress.yaml
│       └── service.yaml
├── .env.example           # Environment template
├── .gitignore
├── CHANGELOG.md
├── Dockerfile             # Docker image for HTTP mode
├── docker-compose.yaml    # Docker Compose config
├── LICENSE
├── main.py                # Entry point
├── pyproject.toml         # Project configuration
└── README.md

API リファレンス

このサーバーは、AceDataCloud Seedance API をラップしています。

• Seedance Videos API - 動画生成
• Seedance Tasks API - タスクの照会

コントリビューション

コントリビューションを歓迎します。以下の手順でお願いします。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing）
5. プルリクエストを作成します

ドキュメント

ドキュメント

ライセンス

MIT License - 詳細は LICENSE をご覧ください。

リンク

• AceDataCloud Platform
• ByteDance Seedance
• Model Context Protocol
• MCP Python SDK

---

こちら の AceDataCloud が心を込めて作成しました。

Cline のセットアップ／Cline の図解付き導入手順

Ace Data Cloud による Seedance — 英語ガイド · 図解付きの手順（完全版）. 2026-10-18 時点で、Cline マーケットプレイスへの申請は審査待ちです。このガイドでは、手動での代替手順を別途説明しています。 / Cline 公式ディレクトリへの申請は引き続き審査待ちです。手動での導入は、掲載済みであることを意味しません。