ffmpeg-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FFMPEG_MCP_WORKDIR | Yes | Confines all input/output media operations to an explicit allowed root directory, blocking path traversal (..) and symlink escapes. Can also be set via the --workdir command line option. |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| probe_mediaB | Inspect media container duration, resolution, codecs, and streams via ffprobe. |
| trim_clipC | Trim a video or audio clip between start_time and end_time/duration. |
| convert_aspect_ratioC | Reframe a video to 9:16, 1:1, 16:9, or 4:5 using crop or pad mode. |
| extract_audioC | Extract audio track from media file into mp3, wav, flac, or m4a. |
| generate_srtB | Generate a validated .srt subtitle file inside the workspace from structured cues. |
| burn_subtitlesC | Burn an .srt subtitle file into a video with customizable font size and vertical margin. |
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 6 tools
Each tool maps to a distinct ffmpeg operation: probing, trimming, aspect-ratio reframing, audio extraction, SRT generation, and subtitle burning. There is no meaningful overlap; generate_srt (create cues) and burn_subtitles (embed an existing .srt) are clearly differentiated by their descriptions.
All six tools follow a consistent snake_case verb_noun pattern (probe_media, trim_clip, extract_audio, burn_subtitles, etc.). Verb choices are accurate and predictable, and convert_aspect_ratio is the only longer name but still fits the convention.
Six tools is a well-scoped surface for a focused ffmpeg wrapper, with each tool earning its place. Nothing feels redundant or padded, and the set stays comfortably in the ideal 3-15 range.
Core operations (probe, trim, reframe, audio extract, subtitle create/burn) are covered, but common ffmpeg workflows are absent: concatenation/merging clips, general format transcoding or compression, frame/thumbnail extraction, and overlays/watermarks. These gaps will force agents to work around missing lifecycle operations.