Video Edit MCP Server 🎬

1# Video Edit MCP Server 🎬
2 
3A 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.
4 
5![Python](https://img.shields.io/badge/python-3.10+-blue.svg)
6![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)
7![License](https://img.shields.io/badge/license-MIT-blue.svg)
8 
9 
10https://github.com/user-attachments/assets/134b8b82-80b1-4678-8930-ab53121b121f
11 
12 
13 
14 
15 
16## ✨ Key Features
17 
18### 🎥 Video Operations
19- **Basic Editing**: Trim, merge, resize, crop, rotate videos
20- **Effects**: Speed control, fade in/out, grayscale, mirror
21- **Overlays**: Add text, images, or video overlays with transparency
22- **Format Conversion**: Convert between formats with codec control
23- **Frame Operations**: Extract frames, create videos from images
24 
25### 🎵 Audio Operations  
26- **Audio Processing**: Extract, trim, loop, concatenate audio
27- **Volume Control**: Adjust levels, fade in/out effects
28- **Audio Mixing**: Mix multiple tracks together
29- **Integration**: Add audio to videos, replace soundtracks
30 
31### 📥 Download & Utilities
32- **Video Download**: Download from YouTube and other platforms
33- **File Management**: Directory operations, file listing
34- **Path Suggestions**: Get recommended download locations
35 
36### 🧹 Memory & Cleanup
37- **Smart Memory**: Chain operations without saving intermediate files
38- **Resource Management**: Clear memory, check stored objects
39- **Efficient Processing**: Keep objects in memory for complex workflows
40 
41### 🔗 Operation Chaining
42Seamlessly 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.
43 
44## 📋 Requirements
45 
46- **Python 3.10 or higher**
47- **moviepy==1.0.3**
48- **yt-dlp>=2023.1.6**
49- **mcp>=1.12.2**
50- **typing-extensions>=4.0.0**
51 
52## ⚙️ Installation & Setup
53 
54 
55 
56### For Claude Desktop / Cursor MCP Integration
57 
58**Ensure that `uv` is installed.**  
59If not, install it using the following PowerShell command:
60 
61```powershell
62powershell -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"
63```
64 
65Add this configuration to your MCP configuration file:
66 
67```json
68{
69  "mcpServers": {
70    "video_editing": {
71      "command": "uvx",
72      "args": [
73        "--python",
74        "3.11",
75        "video-edit-mcp"
76      ]
77    }
78  }
79}
80```
81 
82**Configuration file locations:**
83- **Claude Desktop (Windows)**: `%APPDATA%/Claude/claude_desktop_config.json`
84- **Claude Desktop (macOS)**: `~/Library/Application Support/Claude/claude_desktop_config.json`
85- **Cursor**: `.cursor/mcp.json` in your project root
86 
87### Manual Installation
88 
89```bash
90git clone https://github.com/Aditya2755/video-edit-mcp.git
91cd video-edit-mcp
92pip install -r requirements.txt
93pip install -e .
94```
95 
96## 🏗️ Project Structure
97 
98```
99video_edit_mcp/
100├── src/
101│   └── video_edit_mcp/
102│       ├── __init__.py
103│       ├── main.py                 # MCP server implementation  
104│       ├── video_operations.py     # Video editing tools
105│       ├── audio_operations.py     # Audio processing tools
106│       ├── download_utils.py       # Download functionality
107│       ├── util_tools.py          # Memory & utility tools
108│       ├── utils.py               # Utility functions
109│     
110├── pyproject.toml                 # Project configuration
111├── requirements.txt               # Dependencies
112├── uv.lock                        # Lock file
113├── LICENSE                        # MIT License
114├── MANIFEST.in                    # Manifest file
115└── README.md
116```
117 
118## 🎯 Example Usage
119 
120```python
121# Chain operations without intermediate files
122video_info = get_video_info("input.mp4")
123trimmed = trim_video("input.mp4", 10, 60, return_path=False)  # Keep in memory
124with_audio = add_audio(trimmed, "background.mp3", return_path=False)  
125final = add_text_overlay(with_audio, "Hello World", x=100, y=50, return_path=True)
126```
127 
128## 🚀 Future Enhancements & Contributions
129 
130We welcome contributions in these exciting areas:
131 
132### 🤖 AI-Powered Features
133- **Speech-to-Text (STT)**: Automatic subtitle generation and transcription
134- **Text-to-Speech (TTS)**: AI voice synthesis for narration
135- **Audio Enhancement**: AI-based noise reduction and audio quality improvement
136- **Smart Timestamps**: Automatic scene detection and chapter generation
137- **Face Tracking**: Advanced face detection and tracking for automatic editing
138- **Object Recognition**: Track and edit based on detected objects
139- **Content Analysis**: AI-powered content categorization and tagging
140 
141## 🤝 Contributing
142 
1431. Fork the repository
1442. Create a feature branch: `git checkout -b feature/amazing-feature`
1453. Commit your changes: `git commit -m 'Add amazing feature'`
1464. Push to the branch: `git push origin feature/amazing-feature`
1475. Open a Pull Request
148 
149## 📄 License
150 
151This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
152 
153---
154 
155<div align="center">
156 
157**Made with ❤️ for the AI and multimedia editing community**
158 
159[⭐ Star this project](https://github.com/Aditya2755/video-edit-mcp) | [🤝 Contribute](https://github.com/Aditya2755/video-edit-mcp/contribute) | [📖 Documentation](https://github.com/Aditya2755/video-edit-mcp#readme)
160 
161</div>