adk-rust-mcp-composer

MCP server for composite media generation. Part of the ADK Rust MCP toolkit.

Overview

Composite media server that orchestrates multiple AI models (Veo, Gemini, Lyria) and FFmpeg to produce rich media outputs — animated GIFs, short-form videos, memes, narrated presentations, and multi-speaker podcasts.

Currently implemented: Google Gemini API (Veo 3.1, Gemini 2.5 Flash, Lyria 3 Clip)

Features

• GIF Generation — Text-to-GIF via Veo video + FFmpeg palette optimization
• Short-Form Video — Vertical 9:16 videos with optional caption overlay
• Meme Generation — AI image with baked-in meme text (Impact style)
• Presentations — Slide-based narrated videos with images, TTS, and background music
• Podcasts — Multi-speaker dialogue with auto-assigned voices and background music
• Dual API — Works with Gemini API key or Vertex AI ADC

Prerequisites

FFmpeg must be installed (for GIF conversion, captions, and audio mixing):

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

Installation

cargo install adk-rust-mcp-composer

Configuration

# Gemini API (required)
export GEMINI_API_KEY=your-api-key

# Or Vertex AI
export PROJECT_ID=your-gcp-project
export LOCATION=us-central1

Tools

gif_generate

Generate an animated GIF from a text prompt. Uses Veo for video generation then converts to optimized GIF.

short_generate

Generate a vertical short-form video (9:16) with audio and optional caption overlay. Optimized for social media.

meme_generate

Generate a meme image with top/bottom text overlay from a text prompt.

presentation_generate

Generate a narrated video presentation from slides. Each slide gets an AI image, TTS narration, and optional background music.

Slide format:

podcast_generate

Generate a multi-speaker podcast/dialogue with background music. Each speaker gets a unique voice.

Script segment format:

Usage Examples

# Stdio (default) — for Claude Desktop, Kiro
adk-rust-mcp-composer

# HTTP — for web apps, ADK agents
adk-rust-mcp-composer --transport http --port 8080

# SSE — for streaming applications
adk-rust-mcp-composer --transport sse --port 8080

Generate a GIF

prompt: "A cat chasing a laser pointer across a living room"
fps: 15
width: 640
output_file: "cat_laser.gif"

Create a short-form video

prompt: "Satisfying coffee pour in slow motion, steam rising"
caption: "Monday motivation ☕"
duration_seconds: 6
output_file: "coffee_short.mp4"

Generate a meme

prompt: "A developer staring at a screen with code"
top_text: "IT WORKS ON MY MACHINE"
bottom_text: "SHIPS TO PRODUCTION"
output_file: "dev_meme.png"

Create a presentation

{
  "slides": [
    {"title": "Introduction", "content": "Welcome to our quarterly review."},
    {"title": "Results", "content": "Revenue grew 25% year over year."},
    {"title": "Next Steps", "content": "We plan to expand into three new markets."}
  ],
  "voice": "Puck",
  "background_music": "Soft corporate background music, upbeat and professional",
  "output_file": "quarterly_review.mp4"
}

Generate a podcast

{
  "script": [
    {"speaker": "Host", "text": "Welcome to Tech Talk! Today we're discussing AI.", "style": "cheerful"},
    {"speaker": "Guest", "text": "Thanks for having me. AI is transforming everything.", "style": "calm"},
    {"speaker": "Host", "text": "Let's dive into the latest developments."}
  ],
  "background_music": "Lo-fi podcast background music, subtle and warm",
  "intro_music": true,
  "output_file": "tech_talk.wav"
}

Output Specs

License

Apache-2.0