luma-mcp-server

Luma MCP Server

Luma MCP Server offers Luma AI's video generation capabilities as an MCP (Model Context Protocol) server. It provides functionalities to generate videos from text or images, and extend or interpolate existing videos.

🌟 Overview

This server provides Luma AI's video generation features as an MCP server. It supports video generation from text and images, as well as extending and interpolating existing videos.

🛠️ Available Tools

• generate_video: Generates a video from a text prompt.

  {
    name: 'generate_video',
    arguments: {
      prompt: "A teddy bear in sunglasses playing electric guitar and dancing",
      loop: true,  // Optional
      callback_url: "https://your-callback-url.com"  // Optional
    }
  }

  Copy

• generate_video_from_image: Generates a video using an image as the starting frame.

  {
    name: 'generate_video_from_image',
    arguments: {
      prompt: "Low-angle shot of a majestic tiger prowling through a snowy landscape",
      image_url: "https://your-image-url.com/start-frame.jpg",
      loop: true,  // Optional
      callback_url: "https://your-callback-url.com"  // Optional
    }
  }

  Copy

• extend_video: Extends an existing video.

  {
    name: 'extend_video',
    arguments: {
      prompt: "Continue the dance sequence",
      source_generation_id: "existing-video-generation-id",
      loop: true,  // Optional
      callback_url: "https://your-callback-url.com"  // Optional
    }
  }

  Copy

• interpolate_videos: Smoothly interpolates between two videos.

  {
    name: 'interpolate_videos',
    arguments: {
      prompt: "Create a smooth transition between the videos",
      start_generation_id: "first-video-generation-id",
      end_generation_id: "second-video-generation-id",
      callback_url: "https://your-callback-url.com"  // Optional
    }
  }

  Copy

🔧 Developer Information

The project is structured as follows:

src/
├── types/          - Type definitions
│   ├── schemas.ts  - Input schemas
│   └── types.ts    - Common type definitions
├── services/       - Business logic
├── handlers/       - Request handlers
│   └── tool-handlers.ts
├── clients/        - External API clients
│   └── luma-client.ts
├── utils/          - Utilities
│   └── error-handler.ts
├── config/         - Configuration
│   └── server-config.ts
└── index.ts        - Entry point

📝 Notes

• Prompts should be written in English.
• Video generation may take some time.
• Be mindful of API usage limits.