SuperAPI AI 工具集

ffmpeg-mcp

ffmpeg-mcp 是一个基于 ffmpeg 命令行实现的 MCP 服务器,让用户可以通过对话方式对本地视频进行搜索、裁剪、拼接、播放、叠加、缩放和抽帧等操作。它提供多个工具接口,包括查找视频路径、获取视频信息、剪辑视频、合并视频、播放视频、视频叠加、视频缩放和从视频中提取帧。该工具目前仅支持 macOS 平台(ARM64 或 x86_64),需下载项目并在 Cline 中配置,安装时需将 args 中的路径替换为实际的 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(视频路径)、fps(每指定秒数提取一帧,设为 0 提取所有帧,设为 1 每秒提取一帧)、output_folder(图像保存目录)、format(提取图像的格式:0 为 PNG,1 为 JPG,2 为 WEBP)、total_frames(最大提取帧数,设为 0 无限制)。

使用方式: 用户需要下载项目,并在 Cline 中进行配置。注意:args 中的值 /Users/XXX/Downloads/ffmpeg 需替换为实际下载的 ffmpeg-mcp 目录。

适用场景: 适用于需要通过对话方式对本地视频进行搜索、裁剪、拼接、播放、叠加、缩放和抽帧等操作的用户,尤其是使用 macOS 平台的开发者或视频处理人员。

限制: 目前仅支持 macOS 平台,包括 ARM64 或 x86_64 架构。其他平台暂未提供支持信息。