vidu-mcp

ローカル

github.com/runapi-aiメディア・デザイン01 週間前に更新

リポジトリ

vidu-mcp について

vidu-mcpは、AIエージェントから動画生成を実行したいユーザー向けの、Viduモデル系列用RunAPI MCPサーバーです。2種類の動画生成エンドポイントに絞り、タスク状況と料金も確認できます。

主な機能

01画像から動画へのタスクを作成
02参照素材から動画へのタスクを作成
03タスク状況と出力URLを確認
04モデルとエンドポイントの料金を照会
05Vidu向けのツールに限定

活用シーン

01画像をもとにVidu動画を生成
02参照素材を使った動画タスクを作成
03非同期タスクの結果を後から確認
04タスク作成前に料金を確認

MCP 対応

互換性のあるMCPクライアントに、RunAPIのVidu生成、タスク状況確認、料金照会ツールを提供します。タスク作成と状況確認にはログインが必要ですが、料金照会は不要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "runapi-builder-vidu": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/vidu-mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "<RUNAPI_API_KEY>"
      }
    }
  }
}

起動コマンドnpx -y @runapi.ai/vidu-mcp

設定が必要な環境変数

RUNAPI_API_KEYシークレットOptional RunAPI API key for headless hosts. Interactive MCP hosts can use the login tool, which writes shared RunAPI config.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@runapi.ai/vidu-mcp0.1.1stdio

ツール

掲載時のツール一覧 · 1 週間前に更新

パラメーター	型	必須	説明
force	boolean	いいえ	現在の認証情報がローカル設定ファイルに由来する場合、ブラウザーログインを再実行します。

詳細

RunAPI Vidu MCP サーバー

AI エージェント向けのVidu APIアクセス：用途を絞った1つのMCP サーバーを通じて、動画生成の実行、非同期結果のポーリング、料金の確認を行えます。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、およびMCP互換のあらゆるホストで動作します。}

インストール | ツール | モデル | エージェント向けプロンプト | 設定 | リンク

このパッケージを選ぶ理由

@runapi.ai/vidu-mcpは、RunAPIのViduモデルラインに特化したModel Context Protocolサーバーです。 RunAPIのカタログ全体を読み込まずに、MCP互換のアシスタントから2つのエンドポイントと2種類のモデルに直接アクセスできます。

エージェントの対象をViduに限定する場合は、このモデル別サーバーを使用してください。1つのアシスタントからRunAPIのすべてのモデルラインを見つけられるようにするには、@runapi.ai/mcpを使用してください。

インストール

Claude Codeに追加します：

claude mcp add vidu -s user -- npx -y @runapi.ai/vidu-mcp

サーバーをリポジトリ内で共有する場合は、プロジェクトスコープを使用します：

claude mcp add vidu -s project -- npx -y @runapi.ai/vidu-mcp

Codex、Cursor、Windsurf、VS Code、Roo CodeなどのMCPホストでも、同じstdioコマンドを使用できます：

{
  "mcpServers": {
    "vidu": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/vidu-mcp"]
    }
  }
}

check_pricingはサインイン前でも動作します。タスクの作成やステータスのポーリングを行うには、アシスタントにloginツールを呼び出すよう依頼してください。ブラウザーでログイン画面が開き、runapi loginが使用するものと同じ~/.config/runapi/config.jsonに認証情報が保存されます。ヘッドレス環境やCIホストでは、MCPホストの起動前にRUNAPI_API_KEYを設定することもできます。

Claude、Cursor、Windsurf、VS Code、Roo Code向けのすぐに使える例はexamples/にあります。

ツール

ツール	認証	目的
`image_to_video`	必要	Viduの画像から動画へのタスクを作成し、必要に応じて終端ステータスまで待機します。タスクID、ステータス、出力URLを返します。
`reference_to_video`	必要	Viduの参照画像から動画へのタスクを作成し、必要に応じて終端ステータスまで待機します。タスクID、ステータス、出力URLを返します。
`get_task`	必要	既存のタスクの現在のステータスと最新のペイロードを取得します。
`check_pricing`	不要	Viduのモデルとエンドポイントの現在の料金を調べます。

モデル

Viduは、2つのエンドポイントで2種類のモデルを提供しています。各ツールでは、対応する以下のモデルを指定できます：

ツール	モデル
`image_to_video`	`vidu-q4-image-to-video`
`reference_to_video`	`vidu-q4-reference-to-video`

モデルの提供状況はリリースによって変わる場合があります。最新のカタログを確認するには、check_pricingまたはViduモデルページを使用してください。

エージェント向けプロンプト

アシスタントに自然な言葉で依頼すると、料金を確認してタスクを作成し、タスクIDと出力URLを返します。

タスクを作成する

Run a Vidu image to video task with RunAPI.

アシスタントはcheck_pricingを呼び出してからimage_to_videoを実行し、タスクID、ステータス、出力URLを返します。

待機せずに送信する

Create the task but don't wait for it to finish.

アシスタントはwait: falseを指定して作成ツールを呼び出し、タスクIDを返します。後でget_taskを使って状況を確認してください。

作成前に料金を確認する

Check current Vidu pricing, then create the task if it matches my request.

アシスタントはcheck_pricingを呼び出します。また、正式なカタログ情報へのリンクとしてViduモデルページを案内できます。

設定

サーバーは、次の順序で認証情報を解決します。

RUNAPI_API_KEY 環境変数。ヘッドレス環境や CI ホストで便利です
~/.config/runapi/config.json。MCP の login ツールまたは runapi login によって作成されます
キーなし。この場合でも check_pricing は利用できます

設定ファイルは通常、login によって管理されます。事前に設定されたヘッドレス用の設定では、次の形式を使用できます。

{
  "apiKey": "your_runapi_key"
}

実際の API キーをコミットしないでください。

リンク

リソース	URL
Vidu モデルページ	https://runapi.ai/models/vidu
npm パッケージ	@runapi.ai/vidu-mcp
GitHub リポジトリ	runapi-ai/vidu-mcp
RunAPI MCP の概要	runapi.ai/mcp
RunAPI ドキュメント	runapi.ai/docs

ライセンス

Apache License, Version 2.0 の下でライセンスされています。

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

vidu-mcp

vidu-mcp について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

RunAPI Vidu MCP サーバー

このパッケージを選ぶ理由

インストール

ツール

モデル

エージェント向けプロンプト

タスクを作成する

待機せずに送信する

作成前に料金を確認する

設定

リンク

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？