v0.3.0 — Real Media Engine
·
528 commits
to master
since this release
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
-oflag 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