Luma AI MCP服务器🎥
Luma AI的Dream Machine API的模型上下文协议服务器。
概述
该MCP服务器与Luma AI的Dream Machine API（v1）集成，通过大型语言模型提供生成、管理和操纵AI生成的视频和图像的工具。它实现了模型上下文协议（MCP），以实现AI助手和Luma创意工具之间的无缝交互。
特性✨
- 文本到视频生成
- 具有关键帧的高级视频生成
- 图像到视频转换
- 视频扩展和插值
- 使用参考图像生成图像
- 在视频中添加音频
- 视频放大
- 信用管理
- 发电跟踪和状态检查
工具🛠️
ping
- 检查Luma API是否正在运行 - 无需参数
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 （boolean，可选）：是否进行视频循环 - keyframes （对象，可选）：用于高级视频生成的开始帧和结束帧： - frame0 和 frame1 其中之一： - {"type": "image", "url": "image_url"} 用于图像关键帧 - {"type": "generation", "id": "generation_id"} 用于视频关键帧
get_generation
- 获取一代的状态 - 输入： - generation_id （string，必填）：要检查的生成ID - 输出包括： - 世代ID - 状态（排队、做梦、完成、失败） - 失败原因（如果失败） - 视频URL（如果已完成）
list_generations
- 列出所有世代 - 输入： - limit （number，可选）：要返回的最大代数（默认值：10） - offset （number，可选）：要跳过的代数
delete_generation
- 删除一代 - 输入： - generation_id （string，必填）：要删除的生成ID
upscale_generation
- 将视频生成升级到更高的分辨率 - 输入： - generation_id （string，必填）：要升级的一代ID - resolution （字符串，必填）：升级视频的目标分辨率（“540p”、“720p”、“1080p”或“4k”之一） - 注： - 生成必须处于完成状态才能升级 - 目标分辨率必须高于原始一代的分辨率 - 每一代只能升级一次
add_audio
- 将AI生成的音频添加到视频生成中 - 输入： - generation_id （必填）：要添加音频的代的ID - prompt （必填）：音频生成提示 - negative_prompt （可选）：音频生成的否定提示 - callback_url （可选）：音频处理完成时通知的URL
generate_image
- 从带有可选参考图像的文本提示中生成图像 - 输入： - prompt （string，必填）：要生成的图像的文本描述 - 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}
get_credits
- 获取当前用户的信用信息 - 无需参数 - 以美分为单位返回可用信用余额
get_camera_motions
- 获取所有支持的相机运动 - 无需参数 - 返回：可用摄影机运动字符串列表
Claude桌面设置🖥️
- 从获取Luma API密钥 Luma AI （注册或登录以获取您的API密钥）
- 将此添加到您的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密钥
- 重新启动克劳德桌面
- 就是这样！现在，您可以在Claude Desktop对话中直接使用Luma AI工具。
快速故障排除🛠️
如果您遇到问题：
- 检查您的API密钥是否正确
- 确保服务器的路径正确
- 通过以下方式查看日志：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
高级视频生成类型🎬
Luma API支持通过关键帧生成各种类型的高级视频：
- 从图像开始：提供
frame0随着type: "image"以及图像URL - 以图像结束：提供
frame1随着type: "image"以及图像URL - 扩展视频：提供
frame0随着type: "generation"以及一代ID - 反向扩展视频：提供
frame1随着type: "generation"以及一代ID - 视频之间的插值：提供两者
frame0和frame1随着type: "generation"以及生成ID
API限制和注意事项📝
- 持续时间：目前API只支持“5秒”或“9秒”的持续时间
- 决心：有效值为“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”
- 州：“排队”、“做梦”、“完成”、“失败”
- 粗化:
- 视频生成只有在处于“完整”状态时才能升级 - 目标分辨率必须高于原始一代的分辨率 - 每一代只能升级一次
- API密钥：环境变量中必需
- API版本：使用Dream Machine API v1
许可证📄
麻省理工学院