ffmpeg-mcp

🚀 FFmpeg-MCP

FFmpeg-MCP 借助 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。