Runway ML

@mindstone/mcp-server-runway

Model Context Protocol ホスト向けの Runway ML MCP サーバーです。Runway の生成 AI モデルを利用した標準化された MCP インターフェースを通じて、AI 動画、画像、音声、スピーチ、効果音を生成し、カスタム音声を管理できます。

ステータス

• バージョン： 0.4.1 · npm
• 認証： API キー（RUNWAYML_API_SECRET）
• ツール： 23（動画、画像、音声、音声、タスク）
• サーフェス： cloud-api
• 機械可読： STATUS.json

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストで次の値を入力するよう求められます：RUNWAYML_API_SECRET、RUNWAY_REQUEST_TIMEOUT_MS、RUNWAY_UPLOAD_TIMEOUT_MS。

{
  "mcpServers": {
    "Runway ML": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-runway"
      ],
      "env": {
        "RUNWAYML_API_SECRET": "",
        "RUNWAY_REQUEST_TIMEOUT_MS": "60000",
        "RUNWAY_UPLOAD_TIMEOUT_MS": "600000"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/runway
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-runway

ローカル

node dist/index.js

設定

環境変数

• RUNWAYML_API_SECRET — Runway API キー（dev.runwayml.com から取得）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と後方互換性のある別名
• RUNWAY_REQUEST_TIMEOUT_MS — Runway JSON API およびホストブリッジへの呼び出しに適用される、送信 HTTP リクエストのタイムアウトの任意の上書き値（正の整数、ミリ秒、最大 30 分）。デフォルト：60000（60 秒）。送信処理が遅く TIMEOUT エラーが発生する場合は値を上げてください。より厳しい時間制限にしたい場合は下げてください。
• RUNWAY_UPLOAD_TIMEOUT_MS — uploadEphemeral の署名付き URL へのアップロード処理（大きなローカルファイルのアップロード）に対する、任意の上書き値（正の整数、ミリ秒、最大 30 分）。デフォルト：600000（10 分）。一般的な家庭用回線（約 5 Mbps）で最大 200 MB のアップロードを行えるよう、十分な余裕を持たせています。接続が遅い場合は値を上げ、より厳しい時間制限にしたい場合は下げてください。

ホスト設定例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Runway": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-runway"],
      "env": {
        "RUNWAYML_API_SECRET": "your-api-key"
      }
    }
  }
}

ローカル開発（npm 公開は不要）

{
  "mcpServers": {
    "Runway": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/runway/dist/index.js"],
      "env": {
        "RUNWAYML_API_SECRET": "your-api-key"
      }
    }
  }
}

ツール（23）

設定

• configure_runway_api_key — Runway API キーを保存します

動画

• generate_video_from_image — 静止画像をアニメーション化して動画にします
• generate_video_from_text — テキストの説明から動画を作成します
• generate_video_from_video — 既存の動画のスタイルを変更または変換します（Aleph 2.0）
• character_performance — 表情や身体の動きでキャラクターをアニメーション化します（Act-Two）
• upscale_video — 動画を最大4Kにアップスケールします（Magnific Video Upscaler）

画像

• generate_image — テキストから画像を生成します。参照画像も指定できます

音声

• generate_speech — ElevenLabsの音声を使用して、テキストから読み上げ音声を生成します
• generate_sound_effect — テキストの説明から効果音を生成します
• swap_voice — 音声ファイルまたは動画ファイル内の声を置き換えます
• dub_audio — 音声を別の言語に翻訳して吹き替えます
• isolate_voice — 背景音声から声を分離します

音声

• list_custom_voices — 作成したカスタム音声をすべて一覧表示します
• create_custom_voice — テキストの説明からカスタム音声を作成します
• preview_voice — 音声の短いプレビューを生成します
• delete_custom_voice — カスタム音声を削除します

タスク管理

• check_runway_task — 生成タスクのステータスを確認します
• wait_for_runway_task — タスクが完了するまで待機します（自動ポーリング）
• cancel_runway_task — タスクをキャンセルまたは削除します
• download_runway_output — Runwayの出力をローカルファイルにダウンロードします
• upload_media — ローカルファイルをRunwayの一時ストレージにアップロードします

アカウント

• get_runway_balance — クレジット残高、ティアごとの上限、使用状況を確認します
• query_credit_usage — モデル別および日別の詳細なクレジット使用状況を照会します

ライセンス

FSL-1.1-MIT — MITへの将来的なライセンス変更を含む、Functional Source License Version 1.1です。本ソフトウェアは2030-04-08にMITライセンスに移行します。