Runware

Runware MCP

AI エージェント（Claude、Cursor、Codex など）に Runware API の全機能（画像生成、動画生成、音声生成、3D、アップスケーリング、背景削除、キャプション生成など）へのアクセスを提供する MCP サーバーです。

インストール

いずれかを選択してください。npx が最も簡単で、グローバルインストールは繰り返し使う場合に高速です。

# Use directly with npx (no install)
npx -y @runware/mcp

# Or install globally
npm install -g @runware/mcp

接続

runware.ai で API キーを取得してください。その後、エージェントから MCP に接続します。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "runware": {
      "command": "npx",
      "args": ["-y", "@runware/mcp"],
      "env": {
        "RUNWARE_API_KEY": "your-api-key"
      }
    }
  }
}

グローバルインストールした場合：

{
  "mcpServers": {
    "runware": {
      "command": "runware-mcp",
      "env": {
        "RUNWARE_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Settings → MCP → Add server の順に選択し、上記と同じ設定を使用します。

Codex

同じコマンドと env を使用して、MCP の設定に追加します。

使い方

接続したら、エージェントに話しかけるだけです。エージェントが適切なツールとモデルを選び、パラメーターを入力します。

• 「森の中にいる猫の画像を生成して」
• 「動画生成に使えるモデルを教えて」
• 「https://example.com/photo.jpg を 4 倍にアップスケールして」
• 「アカウント残高を見せて」
• 「アニメ風の Civitai LoRA を探して」

エージェントが適切なモデルや渡すパラメーター、レスポンスの解釈方法を判断します。送信前に各モデルのスキーマに照らしてパラメーターが検証されるため、値を誤って指定した場合もエージェントはすぐにフィードバックを得られます。

エージェントが利用できるツール

これらを直接呼び出す必要はありません。依頼の内容に応じてエージェントが呼び出します。

• run — 指定したモデルで Runware のあらゆる推論タスク（画像、動画、音声、3D、アップスケーリング、キャプション生成など）を実行します
• model_schema — 特定のモデルのパラメータースキーマを取得します
• list_models — Runware 公式の厳選モデル連携を一覧表示します（capability、category、creator、search フィルターに対応）
• model_details — AIR を指定して、厳選モデルのメタデータをすべて取得します
• model_examples — 厳選モデルの入出力サンプルを取得します
• model_pricing — 厳選モデルの料金概要と設定ごとの例を取得します
• list_capabilities — ラベル付きのすべてのモデル機能（例：io:text-to-image、op:upscale）を一覧表示します
• model_search — コミュニティモデルカタログ（Civitai のファインチューン、カスタムアップロード）を検索します
• media_storage — 入力として使うメディア（画像、動画、音声、3D モデル）を保存、または保存済みメディアを削除します
• model_upload — カスタムモデルをアップロードします
• account — 残高や使用状況などのアカウント情報を取得します
• get_task_details — 以前のタスクの元のリクエストとレスポンスを取得します

環境変数

変数	必須	説明
RUNWARE_API_KEY	はい	Runware API キー

開発

# Run directly (no build step)
npm run dev

# Build
npm run build

# Test
npm test

# Lint
npm run lint

# Smoke-test the stdio protocol
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | RUNWARE_API_KEY=your-key node dist/index.js

# Or use the MCP Inspector for a UI
npx @modelcontextprotocol/inspector node dist/index.js