kling-mcp

RunAPI Kling MCP サーバー

AI エージェント向けの Kling API アクセス：ひとつの専用 MCP サーバーで、動画生成の実行、非同期結果のポーリング、料金の確認ができます。

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

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

---

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

@runapi.ai/kling-mcp は、RunAPI の Kling モデルシリーズに特化した Model Context Protocol サーバーです。 MCP 互換アシスタントは、RunAPI の全カタログを読み込まずに、6 つのエンドポイントと 16 種類のモデルバリエーションを直接利用できます。

エージェントの対象を Kling に限定する場合は、このモデル専用サーバーを使用してください。ひとつのアシスタントで RunAPI のすべてのモデルシリーズを検索する場合は、@runapi.ai/mcp を使用してください。

kling-ai-avatar-v1-pro は 2026-10-14T00:00:00Z に廃止されました。新しいリクエストは、タスクの作成や残高の差し引きが行われる前に HTTP 410 を返します。既存のタスクは引き続き照会できます。このモデル ID は別のモデルには割り当てられていません。

kling-v1-avatar-standard は 2026-10-14T00:00:00Z に廃止されました。新しいリクエストは、タスクの作成や残高の差し引きが行われる前に HTTP 410 を返します。既存のタスクは引き続き照会できます。このモデル ID は別のモデルには割り当てられていません。

---

インストール

Claude Code に追加します：

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

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

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

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

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

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

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

---

ツール

ツール	認証	目的
ai_avatar	必要	Kling の AI アバタータスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
edit_video	必要	Kling の動画編集タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
extend_video	必要	Kling の動画延長タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
image_to_video	必要	Kling の画像から動画を生成するタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
motion_control	必要	Kling のモーションコントロールタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_video	必要	Kling のテキストから動画を生成するタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	必要	既存のタスクの現在のステータスと最新のペイロードを取得します。
check_pricing	不要	Kling のモデルとエンドポイントの最新料金を確認します。

---

モデル

Kling は 6 つのエンドポイントで 16 種類のモデルを提供しています。各ツールは、それぞれに記載されたモデルを受け付けます。

ツール	モデル
ai_avatar	kling-ai-avatar-pro、kling-ai-avatar-standard
edit_video	kling-v3-omni-edit、kling-v3-omni-reference
extend_video	kling-v2.5-turbo-image-to-video-pro、kling-v2.5-turbo-text-to-video-pro
image_to_video	kling-o1、kling-v2.1-master-image-to-video、kling-v2.1-pro、kling-v2.1-standard、kling-v2.5-turbo-image-to-video-pro、kling-v2.6、kling-v3-omni、kling-v3-turbo-image-to-video
motion_control	kling-3.0、kling-v2.6
text_to_video	kling-3.0、kling-o1、kling-v2.1-master-text-to-video、kling-v2.5-turbo-text-to-video-pro、kling-v2.6、kling-v3-omni、kling-v3-omni-reference、kling-v3-turbo-text-to-video

モデルの提供状況はリリースによって変わる場合があります。現在のカタログを確認するには、check_pricing または Kling のモデルページ をご利用ください。

---

エージェント向けプロンプト

アシスタントには自然言語で依頼してください。料金を確認してタスクを作成し、タスク ID と出力 URL を返すことができます。

タスクを作成する

Run a Kling ai avatar task with RunAPI.

アシスタントは check_pricing を呼び出してから ai_avatar を呼び出し、タスク ID、ステータス、出力 URL を返すことができます。

待機せずに送信する

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

アシスタントは作成ツールを wait: false で呼び出し、タスク ID を返します。後で get_task を使って状況を確認してください。

作成前に料金を確認する

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

アシスタントは check_pricing を呼び出します。また、正規のカタログ情報として Kling のモデルページ へのリンクを案内できます。

---

設定

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

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

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

{
  "apiKey": "your_runapi_key"
}

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

---

リンク

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

---

ライセンス

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