Doubao Image Video MCP

🚀 豆包画像/動画生成 MCP サーバー

このプロジェクトは、豆包の画像生成と動画生成をサポートする MCP (Model Context Protocol) サーバーです。画像や動画の生成を簡単に行うことができます。

🚀 クイックスタート

このセクションでは、豆包画像/動画生成 MCP サーバーをすぐに使い始めるための手順を説明します。

✨ 主な機能

• 画像生成：豆包 Seedream モデルを使用して高品質な画像を生成します。
• 動画生成：豆包 Seedance モデルを使用して動画を生成します。
• タスク照会：動画生成タスクの状態を照会することができます。

📦 インストール

ローカルインストール

cd doubao-image-video-mcp
pnpm install
pnpm build

📚 ドキュメント

API Key の取得

1. 火山エンジン豆包大モデルプラットフォームにアクセスします。
2. アカウントを登録またはログインします。
3. コンソールで API Key を取得します。

推論エンドポイントの作成

1. 火山エンジンコンソールにアクセスします。
2. 「開通管理」ページに入り、「協力報酬プログラム」に参加して無料のリソースパッケージを利用します。
3. 画像生成エンドポイント（Doubao-Seedream-4.5 モデル）を承認します。
4. 動画生成エンドポイント（Doubao-Seedance-1.0-lite-t2v モデル）を承認します。
5. 「セキュリティ管理」ページに入り、コンテンツセキュリティをクリックし、エンドポイント ID をコピーして設定ファイルに貼り付けます。

PS: 画像生成と動画生成では異なるエンドポイントを設定します。

設定

Claude Code での使用 (推奨)

Claude Code の設定ファイルに以下の内容を追加します。

macOS/Linux: ~/.claude/config.json Windows: %APPDATA%\claude\config.json

{
  "mcpServers": {
    "doubao-giv": {
      "command": "npx",
      "args": ["-y", "doubao-image-video-mcp@latest"],
      "env": {
        "DOUBAO_API_KEY": "your_api_key_here",
        "DOUBAO_IMAGE_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx",
        "DOUBAO_VIDEO_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx"
      }
    }
  }
}

汎用 MCP クライアント設定

{
  "mcpServers": {
    "doubao-giv": {
      "command": "npx",
      "args": ["-y", "doubao-image-video-mcp@latest"],
      "env": {
        "DOUBAO_API_KEY": "your_api_key_here",
        "DOUBAO_IMAGE_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx",
        "DOUBAO_VIDEO_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx"
      }
    }
  }
}

npx -y を使用すると、最新バージョンが自動的にインストールされ、ローカルファイルを手動で管理する必要がありません。

ローカル開発設定

ソースコードから実行する場合：

{
  "mcpServers": {
    "doubao-giv": {
      "command": "node",
      "args": ["/absolute/path/to/doubao-image-video-mcp/dist/index.js"],
      "env": {
        "DOUBAO_API_KEY": "your_api_key_here",
        "DOUBAO_IMAGE_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx",
        "DOUBAO_VIDEO_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx"
      }
    }
  }
}

環境変数

⚠️ 重要提示

火山エンジンコンソールで推論エンドポイントを作成し、エンドポイント ID を設定する必要があります。直接モデル名を使用すると、権限の問題で呼び出しが失敗する可能性があります。

💻 使用例

サポートされているツール

1. generate_image

単一の画像を生成します。

パラメータ:

• prompt (必須): 画像の説明テキスト
• model (オプション): モデルの選択、デフォルトは doubao-seedream-4-5
• size (オプション): 画像のサイズ、デフォルトは 2560x1440
• image_url (オプション): 参照画像の URL (画像から画像の生成)
• ref_image_urls (オプション): 複数の参照画像の URL 配列 (複数の画像の融合)
• req_key (オプション): リクエスト識別子

2. generate_video

動画を生成します（非同期タスク）。

パラメータ:

• prompt (必須): 動画の説明テキスト (最大 500 文字)
• model (オプション): モデルの選択、デフォルトは doubao-seedance-1.0-lite-t2v
• video_duration (オプション): 動画の長さ (秒)、デフォルトは 5
• fps (オプション): フレームレート、デフォルトは 24
• resolution (オプション): 解像度、デフォルトは 1080p
• first_frame_image_url (オプション): 最初のフレームの画像の URL (画像から動画の生成)
• ref_image_urls (オプション): 参照画像の URL 配列
• req_key (オプション): リクエスト識別子

戻り値: タスク ID。query_video_task を使用して結果を照会する必要があります。

3. query_video_task

動画生成タスクの状態を照会します。

パラメータ:

• task_id (必須): 動画生成タスクの ID

戻り値: タスクの状態と結果

サポートされているモデル

画像生成モデル

動画生成モデル

API ドキュメント

• 動画生成タスクの作成 API
• 動画生成タスクの照会 API
• 画像生成 API

よくある質問

Q: 動画生成にはどれくらいの時間がかかりますか？

A: 動画生成は非同期タスクで、通常数秒から数分かかります。具体的な時間は動画の長さとモデルの選択によって異なります。

Q: 推論エンドポイントの Endpoint ID をどのように取得できますか？

A: 火山エンジンコンソールで推論エンドポイントを作成した後に取得できます。endpoint_id パラメータを使用する方が、直接 model 名を使用するよりも安定しています。

Q: どのような画像サイズがサポートされていますか？

A: 画像生成は複数のサイズをサポートしています。1920x2160、1920x2560、2160x3840 などの高解像度サイズを推奨します（豆包 API では画像が少なくとも 3686400 ピクセル必要です）。

貢献の方法

このプロジェクトへの貢献を歓迎します！Issue や Pull Request を送信してください。

1. このリポジトリを Fork します。
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')
4. ブランチにプッシュします (git push origin feature/AmazingFeature)
5. Pull Request を作成します。

貢献ガイド

• 既存のコードスタイルに従ってください。
• 必要なテストとドキュメントを追加してください。
• コミットする前に pnpm build を実行して、ビルドが成功することを確認してください。

リリースプロセス

このプロジェクトは GitHub Actions を使用して自動的に npm にリリースされます。

1. package.json のバージョン番号を更新します。
2. Git タグを作成してプッシュします。

   git tag v1.0.0
   git push origin v1.0.0
   

3. GitHub Actions が自動的にビルドして npm にリリースします。

Star 履歴

📄 ライセンス

MIT

このプロジェクトが役に立った場合は、Star ⭐️ をしていただけると幸いです。