luma-mcp

RunAPI Luma MCP サーバー

AI エージェントからLumaの過去のタスクにアクセスできます。目的を絞った1つのMCP サーバーを通じて、既存のタスクを照会できます。

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

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

---

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

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

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

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

---

インストール

Claude Codeに追加します。

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

サーバーをリポジトリで共有する場合は、プロジェクトスコープを使用してください。

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

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

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

このパッケージのモデルは、新しいタスクを受け付けません。check_pricingは、対応モデルがないことを返します。過去のタスクを検索するには、アシスタントにloginツールを呼び出すよう依頼してください。ブラウザでログインし、runapi loginと同じ~/.config/runapi/config.jsonに認証情報を保存します。 ヘッドレスホストやCIホストでも、MCPホストの起動前にRUNAPI_API_KEYを設定すれば使用できます。

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

---

ツール

ツール	認証	用途

| get_task | 必要 | 既存のタスクについて、現在のステータスと最新のペイロードを取得します。 | | check_pricing | 不要 | このモデル系列は提供終了しているため、対応モデルがないことを返します。 |

---

モデル

Lumaは、0個のエンドポイントにわたって0種類のモデルバリアントを提供します。各ツールで使用できるモデルは、次のとおりです。

ツール	モデル

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

---

エージェントプロンプト

get_taskで既存のタスクを照会します。提供終了したこのモデルへの新しいリクエストはHTTP 410を返します。

Check the status of my existing Luma task with RunAPI.

アシスタントはタスクIDを指定してget_taskを呼び出し、ステータスと利用可能な結果を返します。

---

設定

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

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

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

{
  "apiKey": "your_runapi_key"
}

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

---

Links

Resource	URL
Luma model page	https://runapi.ai/models/luma
npm package	@runapi.ai/luma-mcp
GitHub repository	runapi-ai/luma-mcp
RunAPI MCP overview	runapi.ai/mcp
RunAPI docs	runapi.ai/docs

---

License

Licensed under the Apache License, Version 2.0.