FFmpeg-MCP Server

by video-creator
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • 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

利用ffmpeg命令行实现一个mcp服务器,可以很方便的,通过对话方式实现本地视频的搜索、裁剪、拼接、播放等功能

支持工具

该服务器实现了以下工具:

  • find_video_path参数为目录和文件名,文件名可以是完整的,也可以不带后缀,在目录中递归搜索,返回完整路径
  • get_video_info参数为视频路径,返回视频信息,包括时长/fps/codec/宽度/高度。
  • clip_video参数为文件路径、开始时间、结束时间或时长,返回修剪后的文件路径
  • concat_videos参数为文件列表、输出路径,如果文件列表中的视频元素,如宽、高、帧率等一致,则自动使用快速模式合成
  • play_video使用ffplay播放视频/音频,支持多种格式,如mov/mp4/avi/mkv/3gp,video_path:视频路径 speed:播放速率 loop:播放次数
  • overlay_video两个视频叠加。 background_video:背景视频路径 overlay_video:前置视频路径 output_path:输出视频路径 location:相对位置 dx:x 偏移 dy:y 偏移
  • scale_video视频比例。video_path:输入视频路径宽度:输出视频宽度,-2 保持宽高高度:输出视频高度,-2 保持宽高输出_path:输出视频路径

更多功能即将推出

安装过程

  1. 下载项目
git clone https://github.com/video-creator/ffmpeg-mcp.git cd ffmpeg-mcp uv sync
  1. Cline 中的配置
{ "mcpServers": { "ffmpeg-mcp": { "autoApprove": [], "disabled": false, "timeout": 60, "command": "uv", "args": [ "--directory", "/Users/xxx/Downloads/ffmpeg-mcp", "run", "ffmpeg-mcp" ], "transportType": "stdio" } } }

注意:args中的值: /Users/XXX/Downloads/ffmpeg需要替换为实际下载的ffmpeg-mcp目录

支持的平台

目前仅支持macos平台,包括ARM64或x86_64

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

MCP 服务器通过 FFmpeg 提供视频处理功能,实现基于对话框的本地视频搜索、修剪、连接和播放功能。

  1. Support Tools
    1. Installation procedure
      1. Supported platforms
        ID: 2zxiyezqfc