FFmpeg-MCP

FFmpeg-MCP

使用 ffmpeg 命令行实现的 MCP 服务，可通过对话便捷地搜索、剪辑、拼接和播放本地视频等

支持的工具

该服务实现了以下工具：

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

更多功能即将推出

安装步骤

1. 下载项目

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

2. 在 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