https://github.com/video-creator/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,clip, overlay, concat and other functions
https://github.com/video-creator/ffmpeg-mcp
Last synced: 3 months ago
JSON representation
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
- Host: GitHub
- URL: https://github.com/video-creator/ffmpeg-mcp
- Owner: video-creator
- License: mit
- Created: 2025-03-25T03:49:19.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-13T09:30:15.000Z (11 months ago)
- Last Synced: 2026-01-07T22:25:41.106Z (3 months ago)
- Language: Python
- Homepage:
- Size: 45.9 KB
- Stars: 109
- Watchers: 1
- Forks: 20
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - ffmpeg-mcp - An MCP server that wraps ffmpeg command-line functionality, allowing conversational control over local video and audio processing tasks via the Model Context Protocol. ([Read more](/details/ffmpeg-mcp.md)) `ffmpeg` `video` `audio-processing` (Media Processing Mcp Servers)
- awesome-mcp-servers - **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,clip, overlay, concat and other functions `python` `mcp` `server` `ai` `pip install git+https://github.com/video-creator/ffmpeg-mcp` (🤖 AI/ML)
- metorial-index - FFmpeg Video Processor - Enables local video search, trimming, stitching, and playback through conversational commands using ffmpeg. Provides tools for finding, clipping, concatenating, and playing video files on macOS platforms. (Content Creation)
- toolsdk-mcp-registry - ❌ ffmpeg-mcp
- best-of-mcp-servers - GitHub
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
## 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