Skip to content

v0.3.0 — Real Media Engine

Choose a tag to compare

@simongonzalezdc simongonzalezdc released this 21 Mar 18:43
· 528 commits to master since this release
a9fec09

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