Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

luma-api-mcp

MCP.Pizza Chef: lumalabs

The luma-api-mcp is an MCP server that provides advanced AI-driven image and video generation capabilities. Powered by Luma AI's Ray (video) and Photon (image) models, it supports customizable prompts, aspect ratios, and style influences. Users can generate images and videos with various model options and input references, enabling rich multimedia content creation through MCP clients like Claude Desktop.

Use This MCP server To

Generate AI-created images from text prompts with style and character references Create AI-generated videos with customizable aspect ratios and looping options Modify existing images using AI-driven style and content adjustments Integrate multimedia generation into MCP client workflows for creative projects Automate content creation pipelines with API key-based access Experiment with different AI models for image and video generation Produce social media-ready visuals with specific aspect ratios Combine multiple image references to influence AI-generated outputs

README

Luma API MCP

Setup

  1. Install Claude Desktop App or any MCP client
  2. Get API Key from https://lumalabs.ai/api/keys
  3. Run sh setup.sh, here it will ask the API Key - paste it from 2.

Run

Open Claude Desktop or any MCP client

Features

Create Image

  • prompt: text
  • aspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21" (default: "16:9")
  • model: "photon-1", "photon-flash-1" (default: "photon-1")
  • image_ref: list of image URLs with weights to influence generation (optional), max 8
  • style_ref: single image URL with weight to influence style (optional), max 1
  • character_ref: list of character image URLs (optional), max 4
  • modify_image_ref: single image URL to modify with weight (optional), max 1

Create Video

  • prompt: text
  • aspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21" (default: "16:9")
  • model: "ray-2", "ray-flash-2", "ray-1-6" (default: "ray-2")
  • loop: boolean (default: false)
  • resolution: "540p", "720p", "1080p", "4k" (default: "720p")
  • duration: "5s", "9s" (default: "5s")
  • frame0_image: image URL (optional)
  • frame1_image: image URL (optional)
  • frame0_id: generation ID (optional)
  • frame1_id: generation ID (optional)

Technical Notes

  • Keyframes: Providing frame0_image/frame1_image gives more control over video start/end points
  • Video Response Time: Typical video generation takes 15-60 seconds depending on duration and resolution
  • Image Response Time: Typical generation takes 5-15 seconds depending on model complexity

luma-api-mcp FAQ

How do I set up the luma-api-mcp server?
Install an MCP client like Claude Desktop, obtain an API key from lumalabs.ai, and run the setup script to configure the server.
What models does luma-api-mcp support for image generation?
It supports 'photon-1' and 'photon-flash-1' models for image creation.
Can I customize the aspect ratio for generated images and videos?
Yes, you can specify aspect ratios such as 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, and 9:21.
Is it possible to influence the style of generated images?
Yes, you can provide a style reference image URL with a weight to guide the style of the output.
How do I modify an existing image using luma-api-mcp?
Use the 'modify_image_ref' parameter with a single image URL and weight to adjust the image.
Can I generate videos that loop continuously?
Yes, the 'loop' parameter can be set to true to create looping videos.
What MCP clients are compatible with luma-api-mcp?
MCP clients like Claude Desktop and others that support MCP protocol can connect to this server.
How secure is the API key usage?
The API key is required for authentication and should be kept confidential to prevent unauthorized access.
Does luma-api-mcp support multiple image references for generation?
Yes, you can provide up to 8 image URLs with weights to influence image generation.
Which LLM providers can be used alongside luma-api-mcp?
While luma-api-mcp focuses on multimedia generation, it can be integrated with LLMs like OpenAI, Claude, and Gemini for enhanced workflows.