Luma AI MCP 服务器 🎥

Luma AI Dream Machine API 的模型上下文协议服务器。

概述

此 MCP 服务器与 Luma AI 的 Dream Machine API (v1) 集成，提供通过大型语言模型生成、管理和操作 AI 生成的视频和图像的工具。 它实现了模型上下文协议 (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")
   • 注意：
     • 生成必须处于已完成状态才能放大
     • 目标分辨率必须高于原始生成的分辨率
     • 每个生成只能放大一次

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 (数组，可选): 用于指导生成的参考图像
       • 每个 ref: {"url": "image_url", "weight": optional_float}
     • style_ref (数组，可选): 样式参考图像
       • 每个 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. 从图像开始：提供 frame0，其中 type: "image" 和图像 URL
2. 以图像结束：提供 frame1，其中 type: "image" 和图像 URL
3. 扩展视频：提供 frame0，其中 type: "generation" 和生成 ID
4. 反向扩展视频：提供 frame1，其中 type: "generation" 和生成 ID
5. 在视频之间插值：同时提供 frame0 和 frame1，其中 type: "generation" 和生成 ID

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" 状态时才能放大
  • 目标分辨率必须高于原始生成的分辨率
  • 每个生成只能放大一次
• API 密钥：需要在环境变量中
• API 版本：使用 Dream Machine API v1

许可证 📄

MIT