The FFmpeg-MCP Server provides a convenient interface for video management and manipulation using FFmpeg, with capabilities including:
- Find Video Path: Search for videos recursively with partial filename matching
- Get Video Info: Retrieve details about videos (duration, fps, codec, resolution)
- Clip Video: Trim videos by specifying start/end times or duration
- Concat Videos: Merge multiple videos with fast or standard concatenation options
- Play Video: Use FFplay to watch videos with adjustable speed and looping
- Overlay Video: Create picture-in-picture effects with customizable positioning
- Scale Video: Resize videos while optionally maintaining aspect ratio
- Extract Frames: Save frames from videos as images (PNG, JPG, WEBP)
Provides tools for video manipulation including searching, clipping, concatenating, playing, overlaying, and scaling videos through FFmpeg's command line capabilities.
Offers platform support for macOS (both ARM64 and x86_64 architectures), allowing the video manipulation tools to function on Apple's desktop operating system.
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 pathget_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 pathconcat_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 usedplay_video
Play video/audio with ffplay, support many format, like mov/mp4/avi/mkv/3gp, video_path: video path speed: play rate loop: play countoverlay_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 offsetscale_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 pathextract_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
Installation procedure
- Download project
- Configuration in Cline
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
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
An MCP server providing video processing capabilities through FFmpeg, enabling dialog-based local video search, trimming, concatenation, and playback functionalities.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that enables users to list, download, search, and manage Zoom meeting transcripts through a structured interface.Last updated -61JavaScriptMIT License
- -security-license-qualityA lightweight server that exposes FFmpeg's video processing capabilities to AI assistants through the Model Context Protocol (MCP), supporting operations like video format conversion, audio extraction, and adding watermarks.Last updated -9TypeScriptMIT License
- -securityAlicense-qualityA MCP server that creates graphic recordings by converting websites or text input into visual summaries using different prompt styles (standard, elementary, timeline).Last updated -TypeScriptMIT License
- AsecurityFlicenseAqualityAn MCP server designed to work with FFmpeg for media processing tasks, offering enhanced performance and secure communication for handling media processing requests.Last updated -26TypeScript