pastorsimon1798/mcp-video

v0.3.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 2mo MCP Developer Tools

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent-tools ai-agents ai-video claude claude-code cli

+14 more

cursor ffmpeg hyperframes mcp mcp-server mcp-tools media-automation model-context-protocol python python-library subtitles video video-automation video-editing

Summary

AI summary

All tools now use real FFmpeg operations via moviepy replacing stub implementation.

Full changelog

What's New

Real Media Processing Engine

All tools now use actual FFmpeg operations via moviepy, replacing the previous stub implementation.

26 MCP Tools

Core: trim, merge, resize, convert, speed, fade, export, thumbnail, preview, storyboard, extract_audio, edit (timeline DSL)
Effects: add_text, add_audio, subtitles, watermark, crop, rotate, filter, blur, color_grade, normalize_audio
Compositing: overlay (PiP), split_screen
Batch: batch (apply operation to multiple files with output_dir support)
Analysis: video_info

Standalone CLI Client

24 subcommands for shell scripts and quick operations: mcp_video trim, mcp_video filter, mcp_video batch, etc.

Video Filters & Effects

Blur, sharpen, brightness, contrast, saturation, grayscale, sepia, invert, vignette, and color presets (warm, cool, vintage, cinematic, noir).

Audio Normalization

Normalize loudness to LUFS targets: YouTube (-16), broadcast (-23), Spotify (-14) with correct true peak calculation.

Batch Processing

Apply the same operation to multiple files in one call, with output_dir support.

Bugfixes

Validate filter_type and color_preset before dict lookup (KeyError → MCPVideoError)
Fix loudnorm true peak formula to fixed -1.5 dBTP
Thread output_dir through batch operations (was silently ignored)
Add audio mapping to split_screen (was producing silent output)
Fix batch CLI -o flag conflict with convention

Testing

380 tests across the full testing pyramid (118 unit, 221 integration, 41 E2E/real-media). CI on Python 3.11+3.12.

Installation

pip install mcp-video

Breaking Changes

All tools switched from stub implementation to real FFmpeg operations via moviepy.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track pastorsimon1798/mcp-video

Get notified when new releases ship.

About pastorsimon1798/mcp-video

Video editing MCP server with 26 tools for trimming, merging, text overlays, audio sync, filters, color grading, audio normalization, picture-in-picture, split-screen, batch processing, format conversion, subtitles, watermarks, and more. 380 tests, CI on Python 3.11+3.12, progress callbacks, works with Claude Code, Cursor, and any MCP client.

All releases →