English Français العربية

Ffmpeg MCP

Community Search and web

Local video search, trimming, stitching and playback through conversation, using the ffmpeg command line.

Source code Documentation

What can you do with Ffmpeg MCP?

  • find_video_path
  • get_video_info
  • clip_video
  • concat_videos
  • play_video
  • overlay_video
  • scale_video
  • extract_frames_from_video

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. FFmpeg-MCP
  2. Support Tools
  3. Installation procedure
  4. Supported platforms

FFmpeg-MCP

Using ffmpeg command line to achieve an mcp server, can be very convenient, through the dialogue to achieve the local video search, tailoring, stitching, playback and other functions

Support Tools

The server implements the following tools:

  • find_video_path The parameters are directory and file name, file name can be complete, or is not suffixed, recursive search in the directory, return the full path
  • get_video_info The parameters are video path, return the video info, linkes duration/fps/codec/width/height.
  • clip_video The parameter is the file path, start time, end time or duration, and returns the trimmed file path
  • concat_videos The parameters are the list of files, the output path, and if the video elements in the list of files, such as width, height, frame rate, etc., are consistent, quick mode synthesis is automatically used
  • play_video Play video/audio with ffplay, support many format, like mov/mp4/avi/mkv/3gp, video_path: video path speed: play rate loop: play count

  • overlay_video Two video overlay.

    background_video: backgroud video path

    overlay_video: front video path

    output_path: output video path

    position: relative location

    dx: x offset

    dy: y offset

  • scale_video Video scale.

    video_path: in video path

    width: out video width, -2 keep aspect

    height: out video height, -2 keep aspect

    output_path: output video path

  • extract_frames_from_video Extract images from a video.

    Parameters:

    video_path (str): The path to the video.

    fps (int): Extract one frame every specified number of seconds. If set to 0, extract all frames; if set to 1, extract one frame per second.

    output_folder (str): The directory where the images will be saved.

    format (int): The format of the extracted images; 0: PNG, 1: JPG, 2: WEBP.

    total_frames (int): The maximum number of frames to extract. If set to 0, there is no limit

More features are coming

Installation procedure

  1. Download project git clone https://github.com/video-creator/ffmpeg-mcp.git cd ffmpeg-mcp uv sync
  2. Configuration in Cline { "mcpServers": { "ffmpeg-mcp": { "autoApprove": [], "disabled": false, "timeout": 60, "command": "uv", "args": [ "--directory", "/Users/xxx/Downloads/ffmpeg-mcp", "run", "ffmpeg-mcp" ], "transportType": "stdio" } } } Note: the value:/Users/XXX/Downloads/ffmpeg in args need to replace the actual download ffmpeg-mcp directory

Supported platforms

Currently, only macos platforms are supported, including ARM64 or x86_64

Frequently asked questions

What is Ffmpeg MCP?

Local video search, trimming, stitching and playback through conversation, using the ffmpeg command line.

How do I install Ffmpeg MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Ffmpeg MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Ffmpeg MCP?

It is published by video-creator. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.