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 许可证。