Ffmpeg MCP Server

`ffmpeg-mcp` is a [Model Context Protocol](https://modelcontextprotocol.io) server that puts the full power of **FFmpeg** behind a clean set of tools

Local serverstdioPython

What is the Ffmpeg MCP Server?

ffmpeg-mcp is a Model Context Protocol server that puts the full power of FFmpeg behind a clean set of tools your LLM can

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_video_metadataProbe a file for streams, codecs, duration, etc.
extract_framesSave frames as images (evenly, by interval, or 1/sec)
extract_audioPull audio out to a .wav file
scale_videoUpscale to 1080p / 2k / 4k, aspect-preserving
crop_videoCrop to a region
clip_videoCut a sub-clip by start + duration
make_gifTurn a segment into an optimized GIF
overlay_imageComposite an image (logo/watermark) with timing & opacity
overlays_videoOverlay a (looping) video onto another
trim_and_concat_operationTrim multiple clips and stitch them together
get_normalized_clipsNormalize clips to a common res/fps/codec (in parallel)
concat_clips_with_transitionConcatenate clips with an xfade transition

How to install the Ffmpeg MCP Server

{
  "mcpServers": {
    "ffmpeg-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ffmpeg-mcp/ffmpeg_mcp",
        "run",
        "main.py"
      ],
      "env": {
        "PYTHONPATH": "/path/to/ffmpeg-mcp"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PYTHONPATHDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Ffmpeg MCP to get video metadata.”
  • “Use Ffmpeg MCP to extract frames.”
  • “Use Ffmpeg MCP to extract audio.”

Frequently asked questions

`ffmpeg-mcp` is a [Model Context Protocol](https://modelcontextprotocol.io) server that puts the full power of **FFmpeg** behind a clean set of tools your LLM can Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.