Luma Ai MCP Server

🚀 Luma AI 夢想機 MCP 服務器 🎥

這是一個專門為 Luma AI 的夢想機設計的 MCP（多鏈路協議）服務器，支持視頻與圖像生成等功能，為用戶帶來多樣化的創作體驗。

🚀 快速開始

獲取 API 密鑰

前往 Luma AI 註冊或登錄賬號，即可獲取你的 API Key。

配置 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 等多種分辨率。
• 模型選擇：提供不同速度與質量平衡的模型選項。

📚 詳細文檔

高級視頻生成類型 🎬

夢想機 API 支持多種高級視頻生成方式：

1. 從圖像開始：提供 frame0 並設置為 "type": "image" 和對應的圖片 URL。
2. 以圖像結束：同樣使用 frame1 作為結尾。
3. 擴展現有視頻：使用 frame0 指向一個已有的生成 ID。
4. 反向擴展：通過 frame1 來實現。
5. 插值處理：同時提供兩個生成 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" 狀態時進行。
  • 目標分辨率必須高於原始生成的分辨率。
  • 每個生成只能被縮放一次。
• API Key：必須通過環境變量提供。
• API 版本：使用夢想機 API v1。

📄 許可證

本項目採用 MIT 許可證。