FFmpeg-MCP

使用ffmpeg命令行实现一个mcp服务器，可以非常方便地通过对话实现本地视频搜索、裁剪、拼接、播放等功能。

<a href="https://glama.ai/mcp/servers/@video-creator/ffmpeg-mcp"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=475845188,1599253641&fm=3081&app=3081&f=PNG?w=760&h=400" alt="FFmpeg-Server MCP server" /> </a>

支持工具

该服务器实现了以下工具： <br/>

• find_video_path 参数是目录和文件名，文件名可以是完整的，也可以是没有后缀的，在目录中递归搜索，返回完整路径。
• get_video_info 参数是视频路径，返回视频信息，如时长/帧率/编解码器/宽度/高度。
• clip_video 参数是文件路径、开始时间、结束时间或持续时间，并返回裁剪后的文件路径。
• concat_videos 参数是文件列表、输出路径，如果文件列表中的视频元素（如宽度、高度、帧率等）一致，则自动使用快速模式合成。
• play_video 使用ffplay播放视频/音频，支持多种格式，如mov/mp4/avi/mkv/3gp，参数包括：video_path: 视频路径，speed: 播放速率，loop: 播放次数。
• overlay_video 两个视频叠加。 <br/> background_video: 背景视频路径 <br/> overlay_video: 前面视频路径 <br/> output_path: 输出视频路径<br/> position: 相对位置<br/> dx: x轴偏移量<br/> dy: y轴偏移量<br/>
• scale_video 视频缩放。 <br/> video_path: 输入视频路径 <br/> width: 输出视频宽度，-2保持比例 <br/> height: 输出视频高度，-2保持比例 <br/> output_path: 输出视频路径 <br/>
• extract_frames_from_video 从视频中提取图像。<br/> 参数： <br/> video_path (str): 视频路径。<br/> fps (int): 每隔指定秒数提取一帧。如果设置为0，则提取所有帧；如果设置为1，则每秒提取一帧。<br/> output_folder (str): 图像保存的目录。<br/> format (int): 提取图像的格式；0: PNG, 1: JPG, 2: WEBP。<br/> total_frames (int): 最大提取帧数。如果设置为0，则没有限制。<br/>

更多功能即将推出

安装步骤

1. 下载项目

git clone  https://github.com/video-creator/ffmpeg-mcp.git
cd ffmpeg-mcp
uv sync

2. 命令行配置

{
  "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架构