Luma AI MCP Server 🎥

Luma AI MCP サーバー 🎥

Luma AI の Dream Machine API 用 Model Context Protocol サーバーです。

概要

この MCP サーバーは、Luma AI の Dream Machine API（v1）と連携し、LLM を介して AI 生成動画や画像を生成、管理、操作するためのツールを提供します。Model Context Protocol（MCP）を実装し、AI アシスタントと Luma のクリエイティブツール間のシームレスなやり取りを可能にします。

機能 ✨

• テキストから動画を生成
• キーフレームを使った高度な動画生成
• 画像から動画への変換
• 動画の延長と補間
• 参照画像を使った画像生成
• 動画への音声追加
• 動画のアップスケーリング
• クレジット管理
• 生成状況の追跡と確認

ツール 🛠️

1. ping

   • Luma API が稼働しているか確認します
   • パラメーターは不要です

2. create_generation

   • 新しい動画生成を作成します
   • 入力：
     • prompt（文字列、必須）：生成する動画のテキストによる説明
     • model（文字列、任意）：使用するモデル（デフォルト："ray-2"）
       • 利用可能なモデル："ray-1-6"、"ray-2"、"ray-flash-2"
     • resolution（文字列、任意）：動画の解像度（選択肢："540p"、"720p"、"1080p"、"4k"）
     • duration（文字列、任意）：動画の長さ（現在サポートされているのは "5s" と "9s" のみです）
     • aspect_ratio（文字列、任意）：動画のアスペクト比（例："16:9"、"1:1"、"9:16"、"4:3"、"3:4"、"21:9"、"9:21"）
     • loop（ブール値、任意）：動画をループさせるかどうか
     • keyframes（オブジェクト、任意）：高度な動画生成の開始フレームと終了フレーム：
       • frame0 および／または frame1 に、以下のいずれかを指定します：
         • 画像キーフレームの場合：{"type": "image", "url": "image_url"}
         • 動画キーフレームの場合：{"type": "generation", "id": "generation_id"}

3. get_generation

   • 生成のステータスを取得します
   • 入力：
     • generation_id（文字列、必須）：確認する生成の ID
   • 出力には以下が含まれます：
     • 生成 ID
     • 状態（queued、dreaming、completed、failed）
     • 失敗理由（失敗した場合）
     • 動画 URL（完了した場合）

4. list_generations

   • すべての生成を一覧表示します
   • 入力：
     • limit（数値、任意）：返す生成の最大数（デフォルト：10）
     • offset（数値、任意）：スキップする生成の数

5. delete_generation

   • 生成を削除します
   • 入力：
     • generation_id（文字列、必須）：削除する生成の ID

6. upscale_generation

   • 動画生成の解像度を上げます
   • 入力：
     • generation_id（文字列、必須）：アップスケールする生成の ID
     • resolution（文字列、必須）：アップスケール後の動画の目標解像度（"540p"、"720p"、"1080p"、"4k" のいずれか）
   • 注意：
     • アップスケールするには、生成が完了状態である必要があります
     • 目標解像度は、元の生成の解像度より高くなければなりません
     • 各生成のアップスケールは 1 回のみ可能です

7. add_audio

   • 動画生成に AI 生成音声を追加します
   • 入力：
     • generation_id（必須）：音声を追加する生成の ID
     • prompt（必須）：音声生成用のプロンプト
     • negative_prompt（任意）：音声生成用のネガティブプロンプト
     • callback_url（任意）：音声処理の完了時に通知する URL

8. generate_image

   • 参照画像を任意で指定して、テキストプロンプトから画像を生成します
   • 入力：
     • prompt（文字列、必須）：生成する画像のテキストによる説明
     • model（文字列、任意）：画像生成に使用するモデル（デフォルト："photon-1"）
       • 利用可能なモデル："photon-1"、"photon-flash-1"
     • aspect_ratio（文字列、任意）：画像のアスペクト比（動画と同じ選択肢）
     • image_ref（配列、任意）：生成のガイドに使用する参照画像
       • 各参照画像：{"url": "image_url", "weight": optional_float}
     • style_ref（配列、任意）：スタイルの参照画像
       • 各参照画像：{"url": "image_url", "weight": optional_float}
     • character_ref（オブジェクト、任意）：キャラクターの参照画像
       • 形式：{"identity_name": {"images": ["url1", "url2", ...]}}
     • modify_image_ref（オブジェクト、任意）：編集する画像
       • 形式：{"url": "image_url", "weight": optional_float}

9. get_credits

   • 現在のユーザーのクレジット情報を取得します
   • パラメーターは不要です
   • 利用可能なクレジット残高を米ドルセント単位で返します

10. get_camera_motions

    • サポートされているすべてのカメラモーションを取得します
    • パラメーターは不要です
    • 戻り値：利用可能なカメラモーション文字列の一覧

Claude Desktop のセットアップ 🖥️

1. Luma AI から Luma API キーを取得します（サインアップまたはログインすると API キーを取得できます）。

2. Claude Desktop の設定ファイルに以下を追加します。

   • macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows の場合：%APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "luma": {
         "command": "uv",
         "args": [
           "run",
           "--project",
           "/path/to/your/luma-ai-mcp-server",
           "-m",
           "luma_ai_mcp_server"
         ],
         "env": {
           "LUMA_API_KEY": "your-luma-api-key-here"
         }
       }
     }
   }
   

   次の項目を置き換えます。

   • /path/to/your/luma-ai-mcp-server をサーバーディレクトリの実際のパスに置き換えます
   • your-luma-api-key-here を実際の Luma API キーに置き換えます

3. Claude Desktop を再起動します。

4. これで完了です！Claude Desktop の会話で Luma AI ツールを直接使用できるようになります。

簡単なトラブルシューティング 🛠️

問題が発生した場合：

1. API キーが正しいことを確認します
2. サーバーへのパスが正しいことを確認します
3. tail -n 20 -f ~/Library/Logs/Claude/mcp*.log でログを確認します

高度な動画生成の種類 🎬

Luma API は、キーフレームを使用したさまざまな種類の高度な動画生成に対応しています。

1. 画像から開始：type: "image" と画像 URL を指定して frame0 を渡します
2. 画像で終了：type: "image" と画像 URL を指定して frame1 を渡します
3. 動画を延長：type: "generation" と生成 ID を指定して frame0 を渡します
4. 動画を逆方向に延長：type: "generation" と生成 ID を指定して frame1 を渡します
5. 動画間を補間：type: "generation" と生成 ID を指定して frame0 と frame1 の両方を渡します

API の制限と注意事項 📝

• 長さ：現在、API が対応している長さは「5s」または「9s」のみです
• 解像度：有効な値は「540p」、「720p」、「1080p」、「4k」です
• モデル：
  • 動画生成：
    • 「ray-2」（デフォルト）- 最高品質ですが、生成に時間がかかります
    • 「ray-flash-2」- 生成がより高速です
    • 「ray-1-6」- レガシーモデルです
  • 画像生成：
    • 「photon-1」（デフォルト）- 最高品質ですが、生成に時間がかかります
    • 「photon-flash-1」- 生成がより高速です
• 生成の種類：動画、画像、高度な生成（キーフレームを使用）
• アスペクト比：「1:1」（正方形）、「16:9」（横向き）、「9:16」（縦向き）、「4:3」（標準）、「3:4」（標準の縦向き）、「21:9」（ウルトラワイド）、「9:21」（ウルトラワイドの縦向き）
• 状態：「queued」、「dreaming」、「completed」、「failed」
• アップスケーリング：
  • 動画生成は「complete」状態の場合にのみアップスケーリングできます
  • 目標解像度は、元の生成の解像度より高くする必要があります
  • 各生成のアップスケーリングは1回のみ可能です
• API キー：環境変数に設定する必要があります
• API バージョン：Dream Machine API v1 を使用します

ライセンス 📄

MIT