Luma Ai MCP Server

🚀 Luma AI Dream Machine MCP Server 🎥

A Multi-Chain Protocol (MCP) server designed for Luma AI's Dream Machine. It enables users to generate high - quality videos and images with various features.

✨ Features

• Video Generation: Supports both basic and advanced video generation, starting or ending from images or existing videos.
• Image Generation: Offers options for high - quality and fast - mode generation.
• Extended Functionality: Allows video extension, reverse extension, and interpolation through keyframes.
• Resolution Support: Includes 540p, 720p, 1080p, and 4k.
• Model Selection: Provides model options with different speed - quality balances.

🚀 Quick Start

Get an API Key

Sign up or log in at Luma AI to obtain your API Key.

Configure Claude Desktop

Add the following content to your configuration file:

{
  "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"
      }
    }
  }
}

Restart Claude Desktop

After completing the configuration, restart your Claude Desktop software.

💻 Usage Examples

Advanced Video Generation Types 🎬

The Dream Machine API supports multiple advanced video generation methods:

1. Start from an Image: Provide frame0 and set "type": "image" along with the corresponding image URL.
2. End with an Image: Use frame1 as the ending.
3. Extend an Existing Video: Point frame0 to an existing generation ID.
4. Reverse Extension: Achieved through frame1.
5. Interpolation: Provide two generation IDs for the system to perform interpolation between them.

📚 Documentation

API Limitations and Notes 📝

• Duration: Currently, only "5s" and "9s" video lengths are supported.
• Resolution: Supported values include "540p", "720p", "1080p", and "4k".
• Model Options:
  • Video Generation:
    • "ray-2" (default) - Best quality, slower speed.
    • "ray-flash-2" - Fast generation.
    • "ray-1-6" - Previous - generation model.
  • Image Generation:
    • "photon-1" (default) - Best quality, slower speed.
    • "photon-flash-1" - Fast generation.
• Generation Types: Include video, image, and advanced mode (with keyframes).
• Aspect Ratio: Supports "1:1" (square), "16:9" (landscape), "9:16" (portrait), "4:3" (standard ratio), "3:4" (standard portrait), "21:9" (ultra - wide), "9:21" (ultra - wide portrait).
• Status: May include "queued", "dreaming", "completed", and "failed".
• Scaling:
  • Video scaling can only be performed when the video is in the "complete" state.
  • The target resolution must be higher than the original generated resolution.
  • Each generation can only be scaled once.
• API Key: Must be provided via an environment variable.
• API Version: Use the Dream Machine API v1.

📄 License

MIT