FFmpeg-MCP

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

支持工具

服务器实现了以下工具：

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

更多功能正在开发中

安装步骤

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