wan-mcp

RunAPI Wan MCP サーバー

AI エージェントが Wan API にアクセスできます。1 つの用途に特化した MCP サーバーで、画像・動画生成の実行、非同期処理の結果確認、料金の確認ができます。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、およびあらゆる MCP 対応ホストで利用できます。}

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

---

このパッケージを使う理由

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

エージェントの対象を Wan に限定したい場合は、このモデル別サーバーを使用してください。1 つのアシスタントから RunAPI のすべてのモデル系列を検索する場合は、@runapi.ai/mcp を使用してください。

---

インストール

Claude Code に追加します。

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

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

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

Codex、Cursor、Windsurf、VS Code、Roo Code、およびその他の MCP ホストでも、同じ stdio コマンドを使用できます。

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

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

Claude、Cursor、Windsurf、VS Code、Roo Code 向けの設定例は、examples/ にあります。

---

ツール

ツール	認証	用途
animate	はい	Wan の animate タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
edit_video	はい	Wan の edit video タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
image_to_video	はい	Wan の image to video タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
speech_to_video	はい	Wan の speech to video タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_image	はい	Wan の text to image タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_video	はい	Wan の text to video タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	はい	既存タスクの現在のステータスと最新のペイロードを取得します。
check_pricing	いいえ	Wan のモデルとエンドポイントの現在の料金を確認します。

---

モデル

Wan は、6 つのエンドポイントで 18 種類のモデルバリアントを提供しています。各ツールで利用できるモデルは、以下のとおりです。

ツール	モデル
animate	wan-2.2-animate-move、wan-2.2-animate-replace
edit_video	wan-2.6-edit-video、wan-2.6-flash-edit-video、wan-2.7-edit-video
image_to_video	wan-2.2-a14b-image-to-video-turbo、wan-2.5-image-to-video、wan-2.6-flash-image-to-video、wan-2.6-image-to-video、wan-2.7-image-to-video
speech_to_video	wan-2.2-a14b-speech-to-video-turbo
text_to_image	wan-2.7-image、wan-2.7-image-pro
text_to_video	wan-2.2-a14b-text-to-video-turbo、wan-2.5-text-to-video、wan-2.6-text-to-video、wan-2.7-r2v、wan-2.7-text-to-video

モデルの提供状況はリリースごとに変更される場合があります。最新のカタログを確認するには、check_pricing またはWan モデルページをご利用ください。

---

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

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

タスクを作成する

Run a Wan animate task with RunAPI.

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

待たずに送信する

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

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

作成前に料金を確認する

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

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

---

設定

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

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

設定ファイルは通常、ログインによって管理されます。事前にプロビジョニングされたヘッドレス設定では、次のように指定できます。

{
  "apiKey": "your_runapi_key"
}

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

---

リンク

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

---

ライセンス

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