WavespeedMCP

WaveSpeed MCP サーバー

WaveSpeed プラットフォーム用の MCP サーバーです。Claude Code、Claude Desktop、Cursor、Cline、その他あらゆる MCP クライアントから、ライブカタログにある任意のモデルを実行できます。画像、動画、音声、3D に対応しています。

オープンソースの @wavespeed/cli と同じ設計に基づいています。

• モデルはハードコードされていません。 カタログはライブ API から取得されます（キャッシュは 1 時間）。プラットフォームに新しいモデルが追加された日から利用できます。
• 生成動詞は 1 つだけです。 run_model はあらゆるモデルを実行します。get_model_schema はモデルが実際に受け付ける入力をエージェントに伝えるため、エージェントは書き込む前に読み取ります。
• 入力は変更されません。 明示的な変換は @path マーカーのみです。input 内の "@./photo.jpg" という値は、ファイルをアップロードして、そのホスト URL に置き換えます。通常のパスはそのまま渡されます。
• 価格は正直に表示されます。 get_price は利用前に見積もりを提示し、数式の最低額を「価格」として表示するのではなく、見積もりに反映されなかった入力（unpriced_inputs）を明示します。

ツール

ツール	機能
list_models	テキストまたはモダリティの種類でライブカタログを検索
get_model_schema	モデルの実際の入力スキーマ（必須項目、プロパティ、デフォルト値）
run_model	実行を送信して完了を待機します。モデルが受け付けない入力キーは拒否されます。@path 入力は自動的にアップロードされ、出力 URL を返します
get_price	unpriced_inputs / at_base_price の開示を含むコスト見積もり
get_balance	アカウントのクレジット残高
upload_file	ローカルファイル → ホスト URL（24 時間のコンテンツハッシュによる重複排除）
get_prediction	ID を指定して任意の実行のステータス／出力を取得します。wait_seconds を指定すると、その実行を待機できます

生成によっては、数分から数時間かかります。run_model は実行を送信すると、すぐに予測 ID を返します（done: false）。その後、アシスタントはその ID と wait_seconds（最大 1800）を指定して get_prediction を呼び出し、done が true になるまで待機します。タスクはサーバー側で実行され続けるため、接続が切れても失われません。短時間で完了するモデルの場合は、run_model に wait_seconds を渡すと、同じ呼び出し内で待機できます。待機中、両方のツールは予測 ID を含む MCP 進捗通知を送信します。

セットアップ

リモート（インストール不要）

同じサーバーが次の場所でホストされています。

https://api.wavespeed.ai/mcp

• Claude on the web / ChatGPT： このアドレスを使ってカスタムコネクターを追加し、開いたWaveSpeedのページで接続を承認してください。承認すると専用のAPIキー（MCP · <app>という名前）が作成されます。接続を解除するには、API Keysページでこのキーを削除してください。
• Claude Code： claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp
• Cursor：
• VS Code： code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}'
• リクエストヘッダーを送信できるその他のクライアント： Authorization: Bearer <your API key>を付けて、URLに接続してください。

ホストされたサーバーのツールは同じですが、ファイルの扱いが異なります。お使いのコンピューター上のファイルを読み取れないため、公開URLを渡すか、HTTPリクエストを送信できるツールからcreate_uploadを使ってください（このツールは一時的なアップロード先と、入力として使用するdownload_urlを返します）。または、ChatGPTではファイルをチャットに添付してください（ChatGPTからのみ内容を渡せるupload_attachmentツールがファイルを取り込み、download_urlを返します）。詳しくは、wavespeed.ai/docs/mcpをご覧ください。

ローカル（npx）

認証にはWAVESPEED_API_KEY、またはCLIに保存されたログイン情報（wavespeed login）が使われます。どちらのツールでも同じログイン情報を使えます。キーはこちら：wavespeed.ai/accesskey。

Claude Code

claude mcp add wavespeed -- npx -y @wavespeed/mcp

Claude Desktop / その他のクライアント（mcpServersの設定）：

{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": ["-y", "@wavespeed/mcp"],
      "env": { "WAVESPEED_API_KEY": "wsk_..." }
    }
  }
}

プロンプトの例

• 「ゴールデンアワーのサイバーパンクなスカイラインを、16:9のヒーロー画像として生成してください。」
• 「./photo.jpgを使って、背景を日差しの差し込むキッチンに差し替えてください。」（エージェントは"@./photo.jpg"を渡します）
• 「./hero.pngに控えめな視差効果を付けてアニメーションにしてください。まず料金を確認してください。」

開発

npm install
npm run dev        # run from source (stdio)
npm run lint       # typecheck
npm run build      # tsc → dist/

ライセンス

MIT

---

WaveSpeed AI — AI画像・動画生成プラットフォーム。 ブラウザーでお試しください：画像生成ツール · 動画生成ツール