create_videoLABSCO SUMMARY
Local files, local FFmpeg, nothing uploaded.
Every operation takes a path on your machine and writes back to it, which makes this usable on footage you would not hand to a hosted editing API. The full tool list lives in the server module rather than the README, so expect the advertised surface to be wider than the examples shown — check tools/list in your client for the exact set your version exposes.
What it is
A video generation and editing service built on FastAPI, MoviePy and FastMCP. The same operations are reachable two ways: as REST endpoints for an application, and as MCP tools for an agent — so an editing pipeline can be driven from a conversation without a separate integration.
What you get
- A simple video created from text on a background —
create_video - Clips trimmed and joined —
cut_video,concatenate_videos - Geometry changes: resize, crop, rotate, mirror horizontally or vertically, and margins added around the frame —
resize_video - Time changes: playback speed, fades, looping, and time effects such as reverse or freeze
- Audio work: volume adjusted, the audio track extracted, faded, or looped —
adjust_volume - Compositing: several videos stacked or gridded together, and text or image overlays applied —
text_overlay - Colour filters applied to a clip
Requirements
Python 3.12+, uv, and FFmpeg installed on the machine — MoviePy needs it for processing. Install dependencies with uv sync from a clone. The package is videoEditor-mcp (0.1.0). No account and no key; everything runs locally against files on disk, and the FastAPI server comes up on http://localhost:8000 with auto-generated docs at /docs. A Dockerfile and docker-compose file ship with the repository if you would rather containerise it.
Setup effort
Build from source — git clone https://github.com/vizionik25/moviepy-mcp.git
USE CASES
01
Trimming and stitching footage by describing the edit
Give start and end times for each clip and have them cut and concatenated without opening an editor.
02
Producing platform-specific versions of one video
Resize, crop and re-time a master clip into the shapes each channel needs.
03
Adding titles and watermarks in bulk
Apply text or image overlays across a batch of clips from one instruction rather than one timeline at a time.
04
Fixing audio levels across a set of clips
Adjust volume, fade in or out, or pull the audio track out for separate work.
6 tools
Listed in project docs. Your client may show a different list.
cut_videoconcatenate_videosresize_videotext_overlayadjust_volumeBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
Python 3.12+
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
Install FFmpeg (Debian/Ubuntu: sudo apt-get update && sudo apt-get install -y ffmpeg; macOS: brew install ffmpeg)
TERMINAL
git clone https://github.com/vizionik25/moviepy-mcp.git
cd moviepy-mcp
uv syncStart only the MCP server, the way start.sh does:
TERMINAL
PYTHONPATH=$(pwd)/src uv run python -m videoEditor_mcp.mcp_serverIt serves Streamable HTTP at http://localhost:8080/mcp — add that address to your MCP client. For a client that launches stdio servers, add --transport stdio to the command instead.
