ffmpeg 명령줄을 사용해 mcp 서버를 구현하면, 대화를 통해 로컬 비디오 검색, 맞춤, 스티칭, 재생 등 다양한 기능을 구현할 수 있어 매우 편리합니다

지원 도구

서버는 다음과 같은 도구를 구현합니다:

• find_video_path 매개변수는 디렉터리와 파일 이름, 파일 이름이 완전하거나 접미사가 붙지 않을 수 있음, 디렉터리 내 재귀 탐색, 전체 경로를 반환하는 것입니다
• get_video_info 매개변수는 비디오 경로, 비디오 정보 반환, 링크 지속 시간/fps/코덱/너비/높이입니다.
• clip_video 매개변수는 파일 경로, 시작 시간, 종료 시간 또는 지속 시간이며, 다듬어진 파일 경로를 반환합니다
• concat_videos 매개변수는 파일 목록, 출력 경로이며, 파일 목록 내 너비, 높이, 프레임 속도 등 비디오 요소가 일관되면 빠른 모드 합성이 자동으로 사용됩니다
• play_video ffplay로 비디오/오디오 재생, MOV/MP4/AVI/MKV/3GP 등 다양한 포맷을 지원, video_path: 비디오 경로 속도: 재생 속도 루프: 재생 횟수
• overlay_video 두 개의 비디오 오버레이.
  background_video: 백그라우드 비디오 경로 overlay_video: 전면 비디오 경로 output_path: 출력 비디오 경로 위치: 상대 위치

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