moviepy-mcp
About
a moviepy mcp server currently with over 20 video and audio editing tools.
Details
- Author
- vizionik25
- Categories
- Productivity, Other
Jump to
Setup
Install moviepy-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/vizionik25/moviepy-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A powerful video generation and editing service powered by FastAPI, MoviePy, and FastMCP.
VideoEditor-MCP provides a comprehensive service for programmatically creating and manipulating video and audio content. It exposes a rich set of tools through both a RESTful API (using FastAPI) and a Model-Context-Protocol (MCP) server, making it easy to integrate video editing capabilities into any application or AI agent-based workflow.
Whether you need to generate simple clips, perform complex edits, or composite multiple videos, this service offers a robust and easy-to-use solution.
- Dual-Interface: Interact via a standard REST API or a flexible MCP server for AI agents.
- Rich Editing Suite: A wide range of tools for video, audio, and compositing tasks.
- Extensible: Built with a modular router-based architecture, making it easy to add new features.
- Containerized: Comes with Docker support for easy deployment and scaling.
- Modern Tooling: Usesuvfor fast dependency management andpytestfor robust testing.
The main chat interface for interacting with the video editing agent.
- Installation
- 🚀 Quick Start
- Environment Setup
- Running the Application
- Video Generation
- Video Editing
- Audio Processing
- Compositing
- Python 3.12+
- uv(a fast Python package installer)
- FFmpeg (required by MoviePy for video processing)
# On Debian/Ubuntu sudo apt-get update && sudo apt-get install -y ffmpeg # On macOS (using Homebrew) brew install ffmpeg
git clone https://github.com/your-username/moviepy-mcp.git cd moviepy-mcp
Install dependencies usinguv:This command creates a virtual environment and installs all required packages frompyproject.toml.
Before running the application, you need to set up the environment variables.
-
Backend Environment:Create a.envfile in the root of the project and add any necessary environment variables for the FastAPI server.
Frontend Environment:Create a.env.localfile in thefrontenddirectory and add your client-side environment variables.
# frontend/.env.local NEXT_PUBLIC_EXAMPLE_VARIABLE=example_value
This project now includes astart.shscript to streamline the development setup. This script handles installing dependencies for both the backend and frontend, and starts both services.
-
Install dependencies and start the development servers:The following command will:
- Install Python dependencies withuv.
- Install Node.js dependencies withnpm.
- Start the FastAPI backend server.
- Start the Next.js frontend development server.
uv sync && cd frontend && npm i && cd ../ && ./start.sh --dev
The FastAPI server will be available athttp://localhost:8000and the frontend athttp://localhost:3000.
The following is a summary of the available API endpoints. For detailed request/response models, please refer to the auto-generated docs athttp://localhost:8000/docs.
- POST /video/generate: Creates a simple video with text on a background.
- POST /video-edits/cut: Trims a video.
- POST /video-edits/concatenate: Joins multiple videos.
- POST /video-edits/resize: Resizes a video.
- POST /video-edits/speed: Changes the playback speed.
- POST /video-edits/color-effect: Applies a color filter.
- POST /video-edits/mirror: Mirrors the video horizontally or vertically.
- POST /video-edits/rotate: Rotates the video.
- POST /video-edits/crop: Crops the video.
- POST /video-edits/margin: Adds a margin around the video.
- POST /video-edits/fade: Applies fade-in or fade-out.
- POST /video-edits/loop: Loops the video content.
- POST /video-edits/time-effect: Applies time-based effects like reverse or freeze.
- POST /audio/volume: Adjusts the volume of a video's audio.
- POST /audio/extract: Extracts the audio track from a video.
- POST /audio/fade: Fades the audio in or out.
- POST /audio/loop: Loops the audio track.
- POST /compositing/composite: Stacks or grids multiple videos together.
- POST /compositing/text-overlay: Adds a text overlay to a video.
- POST /compositing/image-overlay: Adds an image overlay to a video.
The MCP server exposes a wide range of tools for agentic workflows. Each tool corresponds to one of the API functionalities.
- create_video(text: str, duration: float)
- cut_video(video_path: str, start_time: float, end_time: float)
- concatenate_videos(video_paths: List[str])
- resize_video(video_path: str, scale: float)
- text_overlay(video_path: str, text: str)
- adjust_volume(video_path: str, factor: float)
- ...and many more!
Refer tosrc/videoEditor_mcp/mcp_server.pyfor a complete list of available tools and their signatures.
To run tests with code coverage analysis:
This project includes aDockerfileanddocker-compose.ymlfor easy containerization.
Run the service:This will start the FastAPI server on port 8000.
This project is licensed under the MIT License. See theLICENSEfile for details.
The World's First AI Music MCP Beyond images and video, your agent can now generate music.
Enables AI assistants to interact with DaVinci Resolve Studio for advanced control over video editing, color grading, and audio.
100% Free AI audio and video transcription with speaker diarization and YouTube support.
Turn any video — YouTube, Instagram, TikTok, Loom, direct URLs, or local files — into transcripts, key frames, OCR text, and metadata for AI agents.
Transcribe and summarize video content from links using various transcription services.
Cinema-grade video production MCP server — 8 tools for recording, editing, effects, captions, TTS, and smart screenshots. Built on ffmpeg + Playwright.
: MCP server for AI media generation (imagesflux, videosveo3.1, music suno v5, with deterministic cost control using reserve-burn-refund billing
Create AI music videos and audio-reactive visuals from songs through MCP.
Interact with MiniMax's powerful Text-to-Speech, image, and video generation APIs.
AI Video, Image & Audio Generation with over 150 models
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




