Luma Ai MCP Server

🚀 Luma AI 梦想机 MCP サーバー 🎥

このサーバーは、Luma AI の梦想機用に設計された MCP（マルチリンクプロトコル）サーバーです。Luma AI の機能を効果的に活用することができます。

🚀 クイックスタート

API キーの取得

Luma AI で登録またはログインし、API キーを取得してください。

Claude Desktop の設定

以下の内容を設定ファイルに追加してください。

{
  "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"
      }
    }
  }
}

Claude Desktop の再起動

設定が完了したら、Claude Desktop ソフトウェアを再起動してください。

✨ 主な機能

• 動画生成：基本および高度な動画生成をサポートし、画像または既存の動画からの開始/終了を含みます。
• 画像生成：高品質と高速モードのオプションを提供します。
• 拡張機能：キーフレームを使用して動画の拡張、反転拡張、および補間を実現します。
• 解像度サポート：540p、720p、1080p、および 4K を含みます。
• モデル選択：速度と品質のバランスが異なるモデルオプションを提供します。

💻 使用例

基本的な使用法

{
  "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"
      }
    }
  }
}

高度な使用法

// 高度な動画生成の設定例
{
  "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"
      },
      "advancedOptions": {
        "videoType": "extended",
        "startFrame": {
          "type": "image",
          "url": "https://example.com/start-image.jpg"
        },
        "endFrame": {
          "type": "image",
          "url": "https://example.com/end-image.jpg"
        }
      }
    }
  }
}

📚 ドキュメント

高度な動画生成タイプ 🎬

梦想機 API は、さまざまな高度な動画生成方法をサポートしています。

1. 画像から開始：frame0 を提供し、"type": "image" と対応する画像 URL を設定します。
2. 画像で終了：同様に frame1 を終了フレームとして使用します。
3. 既存の動画を拡張：frame0 を既存の生成 ID に設定します。
4. 逆拡張：frame1 を使用して実現します。
5. 補間処理：2 つの生成 ID を提供し、システムがそれらの間で補間を行います。

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 バージョン：梦想機 API v1 を使用します。

📄 ライセンス

MIT