mcp-veo3

# MCP Veo 3 Video Generation Server A Model Context Protocol (MCP) server that provides video generation capabilities using Google's Veo 3 API through the Gemini API. Generate high-quality videos from text prompts or images with realistic motion and audio. ## Features - 🎬 **Text-to-Video**: Generate videos from descriptive text prompts - 🖼️ **Image-to-Video**: Animate static images with motion prompts - 🎵 **Audio Generation**: Native audio generation with Veo 3 models - 🎨 **Multiple Models**: Support for Veo 3, Veo 3 Fast, and Veo 2 - 📐 **Aspect Ratios**: Widescreen (16:9) and portrait (9:16) support - ❌ **Negative Prompts**: Specify what to avoid in generated videos - 📁 **File Management**: List and manage generated videos - ⚡ **Async Processing**: Non-blocking video generation with progress tracking ## Supported Models | Model | Description | Speed | Quality | Audio | |-------|-------------|-------|---------|-------| | `veo-3.0-generate-preview` | Latest Veo 3 with highest quality | Slower | Highest | ✅ | | `veo-3.0-fast-generate-preview` | Optimized for speed and business use | Faster | High | ✅ | | `veo-2.0-generate-001` | Previous generation model | Medium | Good | ❌ | ## 📦 Installation Options ```bash # Run without installing (recommended) uvx mcp-veo3 --output-dir ~/Videos/Generated # Install globally pip install mcp-veo3 # Development install git clone && cd mcp-veo3 && uv sync ``` ## Installation ### Option 1: Direct Usage (Recommended) ```bash # No installation needed - run directly with uvx uvx mcp-veo3 --output-dir ~/Videos/Generated ``` ### Option 2: Development Setup 1. **Clone this directory**: ```bash git clone https://github.com/dayongd1/mcp-veo3 cd mcp-veo3 ``` 2. **Install with uv**: ```bash uv sync ``` Or use the automated setup: ```bash python setup.py ``` 3. **Set up API key**: - Get your Gemini API key from [Google AI Studio](https://makersuite.google.com/app/apikey) - Create `.e…