trim_videoLABSCO SUMMARY
FFmpeg's capability without FFmpeg's command line.
The named operations cover what most edits actually need, and apply_filter takes a raw filter string for everything they do not — so the ceiling is FFmpeg's, not the tool list's. Files stay on your disk and paths are explicit, which makes it usable on footage you would never upload.
What it is
A video editing MCP server built on FastMCP and ffmpeg-python. It works on files in a local workspace rather than uploads, and the documented tool set spans 35+ operations across basic edits, audio, effects and colour, format conversion, composition and analysis. Long operations report progress back through the MCP context, and the workspace is browsable as resources.
What you get
- The four everyday edits — segment extraction, resolution change, joining clips, and metadata inspection —
trim_video,resize_video,concatenate_videos,get_video_info - Audio extracted, added or replaced, tracks merged, and a spectrum visualisation rendered —
extract_audio,add_audio,merge_audio_tracks,extract_audio_spectrum - Any FFmpeg filter string applied directly, plus speed changes, colour grading, motion blur and stabilization as named operations —
apply_filter,change_speed,apply_color_grading,apply_motion_blur,apply_video_stabilization - Format and codec conversion, and a frame pulled out as a thumbnail —
convert_format,generate_thumbnail - Composition: slideshows from images, multi-video mosaics, picture-in-picture, time lapses and transitions between clips —
create_video_slideshow,create_video_mosaic,create_picture_in_picture,create_time_lapse,create_video_transitions - Analysis: frames extracted, scene changes detected, technical statistics and dominant colours reported —
extract_frames,detect_scene_changes,extract_video_statistics,extract_dominant_colors - Text and graphics over the picture, and batch processing across several files —
add_text_overlay,create_animated_text,batch_process_videos - The workspace readable as resources:
videos://listfor what is there andvideos://{filename}/metadatafor one file
Requirements
FFmpeg on the machine — everything here is a wrapper around it — and Python 3.13 or newer. pip install vfx-mcp gives a vfx-mcp command the client runs over stdio; a Nix flake and a uv sync path both exist for running from a clone. No account and no key: tools take input and output paths, and VFX_WORK_DIR points the server at the directory holding your footage. Rendering is CPU work on your own machine, so long jobs are long — progress is reported while they run.
Setup effort
One command — pip install vfx-mcp
USE CASES
Cutting a highlight reel out of raw footage
Trim the segments you want out of each source, join them in order, and lay a music track over the result.
Preparing one master for the web
Transcode to a web-friendly codec, render the sizes you need for different viewports, and pull a frame for the poster image.
Finding the interesting parts of a long recording
Detect scene changes to get the cut points, read the technical statistics, and extract frames at the boundaries to see what each section is.
Making shaky handheld footage watchable
Stabilize it, grade the colour, and apply any FFmpeg filter the named operations do not cover.
Building a montage or a comparison out of several clips
Lay clips out as a mosaic or overlay one on another as picture-in-picture, then put transitions between the sections.
Getting audio out of a pile of videos
Extract the audio track from each file in the workspace, listing what is there first so the batch covers the right set.
29 tools
Listed in project docs. Your client may show a different list.
get_video_inforesize_videoconcatenate_videosextract_audioadd_audioextract_audio_spectrummerge_audio_tracksapply_filterchange_speedapply_color_gradingapply_motion_blurapply_video_stabilizationgenerate_thumbnailconvert_formatcreate_video_slideshowcreate_video_mosaiccreate_picture_in_pictureextract_framesdetect_scene_changesextract_video_statisticsextract_dominant_colorsadd_text_overlaycreate_animated_textcreate_green_screen_effectcreate_particle_systemapply_3d_transformsapply_lens_effectsbatch_process_videosBEFORE YOU INSTALL
What to know first
Tools you get
29 tools named in the project's documentation.
Requires
- vfx-mcp on PATH
- Python 3.13+
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
pip install vfx-mcpMCP Clients
Claude Desktop
{
"mcpServers": {
"vfx": {
"command": "vfx-mcp",
"args": []
}
}
}Claude Desktop — from source
{
"mcpServers": {
"vfx": {
"command": "uv",
"args": [
"run",
"python",
"<YOUR_PATH_TO_VFX_MCP>/main.py"
],
"cwd": "<YOUR_PATH_TO_VFX_MCP>"
}
}
}