Video Edit MCP Server 🎬

A powerful Model Context Protocol (MCP) server designed for advanced video and audio editing operations. This server enables MCP clients—such as Claude Desktop, Cursor, and others—to perform comprehensive multimedia editing tasks through a standardized and unified interface.

https://github.com/user-attachments/assets/134b8b82-80b1-4678-8930-ab53121b121f

✨ Key Features

🎥 Video Operations

• Basic Editing: Trim, merge, resize, crop, rotate videos
• Effects: Speed control, fade in/out, grayscale, mirror
• Overlays: Add text, images, or video overlays with transparency
• Format Conversion: Convert between formats with codec control
• Frame Operations: Extract frames, create videos from images

🎵 Audio Operations

• Audio Processing: Extract, trim, loop, concatenate audio
• Volume Control: Adjust levels, fade in/out effects
• Audio Mixing: Mix multiple tracks together
• Integration: Add audio to videos, replace soundtracks

📥 Download & Utilities

• Video Download: Download from YouTube and other platforms
• File Management: Directory operations, file listing
• Path Suggestions: Get recommended download locations

🧹 Memory & Cleanup

• Smart Memory: Chain operations without saving intermediate files
• Resource Management: Clear memory, check stored objects
• Efficient Processing: Keep objects in memory for complex workflows

🔗 Operation Chaining

Seamlessly chain multiple operations together without creating intermediate files. Process your video through multiple steps (trim → add audio → apply effects → add text) while keeping everything in memory for optimal performance.

📋 Requirements

• Python 3.10 or higher
• moviepy==1.0.3
• yt-dlp>=2023.1.6
• mcp>=1.12.2
• typing-extensions>=4.0.0

⚙️ Installation & Setup

For Claude Desktop / Cursor MCP Integration

Ensure that uv is installed.
If not, install it using the following PowerShell command:

powershell -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"

Add this configuration to your MCP configuration file:

{
  "mcpServers": {
    "video_editing": {
      "command": "uvx",
      "args": [
        "--python",
        "3.11",
        "video-edit-mcp"
      ]
    }
  }
}

Configuration file locations:

• Claude Desktop (Windows): %APPDATA%/Claude/claude_desktop_config.json
• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: .cursor/mcp.json in your project root

Manual Installation

git clone https://github.com/Aditya2755/video-edit-mcp.git
cd video-edit-mcp
pip install -r requirements.txt
pip install -e .