FFmpeg-MCP
@video-creator
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,clip, overlay, concat and other functions
Overview
What is FFmpeg-MCP?
An MCP server that wraps FFmpeg command-line tools to enable local video search, trimming, stitching, playback, and other operations through natural language dialogue with an AI assistant. It is intended for users who want to manipulate video files on their Mac via an MCP client like Cline.
How to use FFmpeg-MCP?
Clone the repository, run uv sync in the project directory, then configure your MCP client with the stdio transport. The client command is uv --directory /path/to/ffmpeg-mcp run ffmpeg-mcp. Tools are invoked automatically by the AI assistant when it processes natural language requests.
Key features of FFmpeg-MCP
- Find video files in a directory recursively.
- Get video metadata (duration, fps, codec, dimensions).
- Trim video by start/end time or duration.
- Concatenate multiple videos with automatic smart mode.
- Play video or audio with ffplay.
- Overlay one video onto another at a specified position.
- Scale video dimensions while preserving aspect ratio.
- Extract frames from a video at a given rate (PNG, JPG, or WEBP).
Use cases of FFmpeg-MCP
- Search for a specific video file by name in a local folder.
- Retrieve detailed technical information about a video.
- Clip a segment from a longer video for quick sharing.
- Combine several video clips into one seamless output.
- Overlay a logo or watermark onto a
