runway-mcp

RunAPI Runway MCP サーバー

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

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

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

---

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

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

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

---

インストール

Claude Codeに追加します：

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

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

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

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

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

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

Claude、Cursor、Windsurf、VS Code、Roo Code向けのサンプルはexamples/にあります。

---

ツール

ツール	認証	用途
extend_video	必要	Runwayの動画延長タスクを作成し、必要に応じて終端ステータスまで待機します。タスクID、ステータス、出力URLを返します。
text_to_video	必要	Runwayのテキストから動画を生成するタスクを作成し、必要に応じて終端ステータスまで待機します。タスクID、ステータス、出力URLを返します。
get_task	必要	既存のタスクの現在のステータスと最新のペイロードを取得します。
check_pricing	不要	Runwayのモデルとエンドポイントの現在の料金を確認します。

---

モデル

Runwayは、2つのエンドポイントにわたって1つのモデルバリアントに対応しています。各ツールで、対応するモデルを指定できます：

ツール	モデル
extend_video	runway
text_to_video	runway

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

---

エージェントプロンプト

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

タスクを作成する

Run a Runway extend video task with RunAPI.

アシスタントはcheck_pricingを呼び出した後、extend_videoを呼び出し、タスクID、ステータス、出力URLを返します。

待たずに送信する

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

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

作成前に料金を確認する

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

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

---

設定

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

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

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

{
  "apiKey": "your_runapi_key"
}

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

---

リンク

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

---

ライセンス

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