Wan27 MCP — AI Image and Video Generation

Wan27 MCP と CLI — AI 画像・動画生成

wan2-7.io のアカウントを使って、ターミナルや AI アシスタントから画像や動画を生成できます。MCP と CLI ではウェブサイトと同じクレジット残高を、同じ料金で使用します。クレジットはウェブサイトでチャージできます。

利用には有料サブスクリプションが有効である必要があります。 クレジットパックのみの購入、無料アカウント、未払いのトライアルでは利用できません。自動更新をオフにしたサブスクリプションでも、有料期間が終了するまでは利用できます。https://wan2-7.io/pricing/ でアップグレードしてください。

Node 22 以降、macOS または Linux（WSL を含む）。

インストール

npm install -g @wan27/cli

使い方

wan27 auth login
wan27 account
wan27 models
wan27 estimate --input request.json
wan27 create --input request.json --wait
wan27 download <taskId> --output result.mp4
wan27 auth logout

request.json の例：

{"modelId":"wan27-text-to-video","prompt":"A paper boat on a rainy street","durationSeconds":5,"resolution":"720p"}

{"modelId":"wan2.7-image","prompt":"A paper crane on a desk","resolution":"2K"}

画像から動画を生成する場合は、最初のフレームをアップロードして、その URL を渡します。

wan27 upload frame.png        # {"url":"https://..."}

{"modelId":"wan27-image-to-video","prompt":"The crane takes off","imageUrl":"https://..."}

wan27 model <modelId> はすべてのオプションと JSON Schema を出力します。

create はリクエスト ID を stderr に出力します。ネットワークエラーの後に --request-id <id> を指定して再実行すると、同じタスクが返され、二重に請求されることはありません。失敗したタスクは自動的に返金されます。wait のタイムアウトは待機を停止するだけで、タスクは引き続き実行されます。

認証情報は macOS Keychain に保存されます。または、--credential-store file を指定すると、プライベートファイル（ディレクトリ 0700、ファイル 0600）に保存されます。WAN27_CONFIG_DIR でそのディレクトリを変更できます。自動化には、事前に発行された API トークンを WAN27_ACCESS_TOKEN で指定できます。ログアウトするとこの接続が無効になります。ウェブサイトのパスワードを変更すると、すべての接続が無効になります。

アシスタントを接続する（ローカル MCP）

wan27 auth login で一度サインインしてから、stdio サーバーを登録します。

codex mcp add wan27 -- wan27 mcp
claude mcp add wan27 -- wan27 mcp

ツール：account_status、list_models、get_model、estimate_generation、generate_image、generate_video、list_tasks、get_task。

サインイン後、JSON 設定を受け付けるクライアントは、npx を使って同じ stdio サーバーを起動できます。

{
  "mcpServers": {
    "wan27": {
      "command": "npx",
      "args": ["-y", "@wan27/cli", "mcp"]
    }
  }
}

生成する前にアカウントの状態を確認し、コストを見積もってください。画像と動画の生成には、ウェブサイトのクレジットを使用します。

ドキュメントとサポート

• Wan27 ウェブサイト
• MCP の設定とクライアント向け手順
• CLI のインストール
• MCP と CLI のワークフローガイド
• サブスクリプションプラン
• 公開クライアントの配布と課題トラッカー

この公開配布版を実行する

このリポジトリには、@wan27/[email protected] の読み取り可能な JavaScript 実行ファイルが含まれています。ホスト型サービスは wan2-7.io で運営されています。

npm ci --ignore-scripts
node dist/cli.mjs --help
node dist/cli.mjs auth login
node dist/cli.mjs mcp

ライセンスと来歴

MIT。リリースの来歴については、PROVENANCE.md を参照してください。 実行ファイルは 0.1.1 から変更されていません。バージョン 0.1.3 では、GitHub リポジトリと MCP Registry の名前空間が NotUsingGithub アカウントに更新されています。

ディレクトリ調査用コンテナー

docker build -t wan27-mcp .
docker run --rm -i wan27-mcp

このコンテナーは、必要な mcp サブコマンドを備えた、npm パッケージと同じバージョンに固定されたクライアント配布版を、非 root ユーザーとして実行します。Linux コンテナーでは macOS Keychain を利用できないため、プライベートファイルの認証情報ストアが明示的に選択されています。空のコンテナーには認証情報がありません。標準入力で MCP JSON-RPC を受け付け、プロトコルの応答を標準出力に書き込みます。MCP の初期化と tools/list は、アカウントやトークンを必要とせず、メディアを作成したりクレジットを消費したりしません。アカウントや生成のツールを呼び出すには、認証済みの Wan27 アカウントが必要です。生成には引き続き有料サブスクリプションが必要で、ウェブサイトのクレジットを消費します。

ビルドでコピーされるのは、配布版と公開メタデータのみです。認証情報やホスト設定は含まれません。Dockerfile やイメージにトークンを埋め込まないでください。