Luma AI MCP Server 🎥

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
     • 状态（排队中、生成中、已完成、失败）
     • 失败原因（如果失败）
     • 视频 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（数组，可选）：用于引导生成的参考图像
       • 每项参考图像：{"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. 从图像开始：提供 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