> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance MCP 接続ガイド

> seedance MCP 服务器集成

[MCP（Model Context Protocol）](https://modelcontextprotocol.io) は Anthropic によって開発されたモデルコンテキストプロトコルで、Claude や GPT などの AI モデルが標準化されたインターフェースを通じて外部ツールを呼び出すことを可能にします。XHuoAPI が提供する 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秒の動画長さに対応
* **音声生成** — 一部モデルは音声の同時生成に対応
* **タスク照会** — 生成進捗の監視および結果取得

## 事前準備

利用前に XHuoAPI API トークンを取得してください：

1. [XHuoAPI プラットフォーム](https://api.xhuoapi.ai) に登録またはログイン
2. [Seedance Videos API](https://api.xhuoapi.ai/documents/seedance-videos) ページへ移動
3. 「Acquire」をクリックして API トークンを取得（初回申請時は無料クレジット付与）

## インストールと設定

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

```bash theme={null}
pip install mcp-seedance
```

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

```bash theme={null}
git clone https://github.com/XHuoAPI/SeedanceMCP.git
cd SeedanceMCP
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`

以下の設定を追加：

```json theme={null}
{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

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

```json theme={null}
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

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

## VS Code / Cursor での使用方法

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

```json theme={null}
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

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

```json theme={null}
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_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 リポジトリ：[XHuoAPI/SeedanceMCP](https://github.com/XHuoAPI/SeedanceMCP)
* PyPI パッケージ：[mcp-seedance](https://pypi.org/project/mcp-seedance/)
* API ドキュメント：[Seedance 動画生成 API](https://api.xhuoapi.ai/documents/seedance)