bobtista_luma-ai-mcp-server

🚀 Luma AI MCP 服务器介绍

Luma AI MCP（媒体创作平台）服务器是一款强大的工具，它允许用户借助 API 创建和编辑视频、图像及其他多媒体内容。接下来，为你详细介绍该服务器的相关信息。

🚀 快速开始

获取 API 密钥

注册或登录 Luma AI 账户，即可获取您的 API 密钥。

配置服务器路径

• 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 替换为您的实际 API 密钥。

重启 Claude Desktop

配置完成后，重启应用以使更改生效。

✨ 主要特性

• 视频生成：支持从头开始创建视频，也可基于现有内容进行扩展、反转扩展或插值操作。
• 图像生成：能够生成高质量的图像，并且支持多种风格和模型。
• 高级功能：涵盖相机动作支持、分辨率调整以及多种模型选择。

📚 详细文档

常见问题解决

• 检查 API 密钥：务必确保密钥正确无误。
• 验证路径配置：确认服务器路径设置正确。
• 查看日志文件：使用命令 tail -n 20 -f ~/Library/Logs/Claude/mcp*.log 查看详细日志。

高级视频生成类型 🎥

Luma API 支持多种视频生成方式：

1. 从图像开始：提供 frame0 和图像 URL。
2. 以图像结束：提供 frame1 和图像 URL。
3. 扩展视频：使用现有生成 ID 扩展视频。
4. 反向扩展视频：使用生成 ID 进行逆向扩展。
5. 插值视频：同时使用两个生成 ID 进行插值。

API 限制与注意事项 📝

• 时长：仅支持 "5s" 或 "9s"。
• 分辨率：有效值包括 "540p", "720p", "1080p", 和 "4k"。
• 模型选择：
  • 视频生成：ray-2（最佳质量，较慢）、ray-flash-2（较快）、ray-1-6（ legacy）。
  • 图像生成：photon-1（最佳质量，较慢）、photon-flash-1（较快）。
• 状态：可能的值包括 "queued", "dreaming", "completed", 和 "failed"。
• 缩放：
  • 视频只能在“完成”状态下缩放。
  • 目标分辨率必须高于原始生成的分辨率。
  • 每个生成只能缩放一次。

📄 许可证

Luma AI MCP 服务器遵循 MIT 许可证，允许自由使用和修改，但需保留版权声明。