video-edit-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| healthA | Report whether ffmpeg/ffprobe and a local Whisper backend are available, with versions. |
| probeA | Inspect a local media file: container, duration, size and per-stream codec/resolution/fps/audio info. |
| trimA | Cut one range out of a media file. Stream-copies when the range starts on a keyframe, re-encodes otherwise. |
| cutA | Keep the listed ranges of one file and join them in order, always re-encoded. |
| concatA | Join several media files into one. Normalization scales/pads resolution, fps and audio to a common layout first. |
| renderA | Encode a file or assemble a timeline with a fixed delivery preset: web-1080p (16:9), vertical-9x16, square (H.264+AAC, fit-and-pad) or audio-only (AAC .m4a). Optional alpha overlay / HyperFrames layers on top (timed, stacked by zIndex, positioned and sized keeping their aspect; off-frame layers are clamped and reported in warnings). Optional captions (SRT/VTT/cues/transcript) burned in after composition with HyperFrames or the ffmpeg fallback. Timeline clips can be still images (png/jpg/webp, durationSec, contain/cover, Ken Burns). Optional two-pass loudness normalization of the final mix. Returns measured width/height/fps/codecs/bytes, the effective program duration (transition overlaps removed) and loudness before/after. |
| export.packageB | Build a delivery ZIP: the media file, optional captions.srt, spec.json (measured duration, resolution, fps, codecs, EBU R128 loudness, preset) and checksums.sha256. |
| composeA | Render a HyperFrames composition (HTML) to video. Needs the optional peer @hyperframes/producer and headless Chrome; returns an 'unavailable' error otherwise. |
| transcribeA | Transcribe a local audio or video file with a local Whisper backend (whisper.cpp or faster-whisper): audio is extracted with ffmpeg to 16 kHz mono, and segments plus word-level timestamps are returned. |
| audio.measureA | Measure integrated loudness (LUFS), true peak (dBTP) and loudness range (LRA) of a media file with ffmpeg loudnorm. |
| audio.loudnormC | Two-pass loudness normalization of a media file to a target integrated loudness (default -14 LUFS) using ffmpeg loudnorm. |
| audio.mixA | Mix a video's voice track with background music, ducking the music under the voice with a sidechain compressor. Video is kept (stream copy); audio is re-encoded. Fades optional. |
| captions.generateB | Write captions from transcription segments or an SRT file: subtitle files (srt/ass) or a HyperFrames composition HTML for animated captions (karaoke word highlight, word-pop, background box). |
| captions.renderB | Burn captions onto a video and keep its audio. The HyperFrames engine (default) renders an animated caption layer; the ffmpeg engine burns in an ASS overlay and needs no extra dependency. Give it transcription segments, an SRT file, or a composition path (engine "hyperframes"). |
| reframeA | Reframe a video to 9:16, 1:1, 16:9 or 4:5. Modes: a centered crop (default), solid-color padding, or blurred-background padding. In "crop" mode, focusX/focusY bias the crop (0..1), and "follow" tracks the subject across time using an optional, lazily-loaded face detector. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Most tools target a clearly distinct operation (probe, trim, cut, concat, reframe, audio.*, captions.*). There is some overlap: render can burn captions and overlay HyperFrames layers, which partially duplicates captions.render, and compose vs render vs export.package touch adjacent rendering/assembly concerns, but descriptions provide enough guidance to choose correctly.
The set mixes bare verbs (render, transcribe, probe, trim, cut, concat, compose, reframe) with dotted namespace.action names (export.package, audio.measure, captions.generate). The namespacing is readable and groups related tools, but it is not a single consistent convention.
15 tools is well within the ideal range for a media-editing server and each tool covers a distinct pipeline stage (inspect, edit, reframe, caption, audio, compose, package, health). No tool appears redundant enough to be cut.
The surface covers the full edit lifecycle: probing, trimming/cutting/concatenating, reframing, captioning, loudness and mixing, composition, packaging, and environment health. Minor gaps exist, such as thumbnail/poster extraction, speed/scale adjustments, and explicit extract-audio, but these are workaroundable.