Happy slice of mcp pizzaMCP.pizza

ffmpeg-mcp

MCP.Pizza Chef: video-creator

Eight editing actions are available: locate a video by name, read its length and format, cut a clip, stitch clips together, play one back, lay one video over another, change the size, and pull out still frames. It runs only on macOS; Windows and Linux return an unsupported-platform message. On first use it downloads its own prebuilt FFmpeg programs from a personal Gitee mirror instead of using any copy already installed. No account or key is needed, and your files never leave the machine.

Files/PDF
Images/Design

Use This MCP server To

Trim a long screen recording down to the good part Stitch several clips into one finished video Shrink a video so it is small enough to send Pull one still image per second out of a clip Check how long a video is and what format it uses Place a small webcam clip in the corner of a recording Find a video file by name anywhere in a folder

README

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

FFmpeg-Server MCP server

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
  1. 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

ffmpeg-mcp FAQ

Does this work on Windows or Linux?
No. Only macOS is supported, on both Intel and Apple Silicon. On anything else every action returns a 'Not Support Platform' message.
Do I need an account, key, or paid plan?
No. There is nothing to sign up for and no usage cost. Everything happens on files already on your computer.
Do I need FFmpeg installed first?
No, and it will ignore a copy you already have. The first time you run it, it downloads prebuilt video programs from a personal Gitee repository and marks them executable, which is worth knowing if your workplace restricts unsigned downloads.
Can I use this to cut a clip out of a long recording?
Yes. Give it the file, a start time, and either an end time or a length, and it saves a new trimmed file next to the original.
Will it change or delete my original video?
No. Every action writes a new file. It does, however, overwrite the destination file without asking if something is already there, so name outputs carefully.
Which apps does it work in?
The project documents Cline, and any app that can run a local MCP server should work the same way.
How hard is setup?
You download the project, run a build step, then paste a small config block containing the folder path you downloaded it to. That is more than a copy-and-paste job.
Can it add text, music, or subtitles?
No. The current actions cover cutting, joining, overlaying, resizing, playback, frame extraction, and file lookup. Nothing else is wired up yet.