Luma AI MCP Server 🎥

Luma AI MCP Server 🎥

site icon
2025.04.01 0
PythonAI 视频生成AI 图像生成创意工具内容生成
Luma AI MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,用于与 Luma AI 的 Dream Machine API (v1) 集成。它提供了通过大型语言模型生成、管理和操作 AI 生成的视频和图像的工具。该服务器支持多种视频和图像生成功能,包括文本到视频生成、图像到视频转换、视频扩展和插值等。
View on GitHub

Overview

基本能力

产品定位

Luma AI MCP Server 是一个用于 AI 生成视频和图像的工具服务器,旨在通过 MCP 协议实现 AI 助手与 Luma AI 创意工具的无缝交互。

核心功能

  • 文本到视频生成
  • 高级视频生成(带关键帧)
  • 图像到视频转换
  • 视频扩展和插值
  • 带参考图像的图像生成
  • 为视频添加音频
  • 视频超分辨率提升
  • 信用管理
  • 生成跟踪和状态检查

适用场景

  • 创意视频生成
  • 图像到视频转换
  • 视频编辑和增强
  • AI 艺术创作

工具列表

  1. ping - 检查 Luma API 是否运行
  2. create_generation - 创建新的视频生成
  3. get_generation - 获取生成状态
  4. list_generations - 列出所有生成
  5. delete_generation - 删除生成
  6. upscale_generation - 提升视频分辨率
  7. add_audio - 为视频添加 AI 生成音频
  8. generate_image - 从文本提示生成图像
  9. get_credits - 获取用户信用信息
  10. get_camera_motions - 获取支持的相机运动

常见问题解答

  • 检查 API 密钥是否正确
  • 确保服务器路径正确
  • 查看日志:tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

使用教程

使用依赖

  1. Luma AI 获取 API 密钥

安装教程

  1. 将以下配置添加到 Claude Desktop 配置文件:
  2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%\Claude\claude_desktop_config.json

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 密钥

  1. 重启 Claude Desktop

调试方式

  1. 检查 API 密钥是否正确
  2. 确保服务器路径正确
  3. 查看日志:tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

许可证

该项目遵循 MIT 开源许可条款。