f

ffmpeg对话式视频处理工具

@video-creator/ffmpeg-mcp
0 Stars 272 次浏览 video-creator 更新于 2026-08-23

一个通过 FFmpeg 提供视频处理功能的 MCP 服务器，支持基于对话的本地视频搜索、剪辑、连接和播放功能。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "ffmpeg-mcp": {
      "args": [
        "--directory",
        "/Users/xxx/Downloads/ffmpeg-mcp",
        "run",
        "ffmpeg-mcp"
      ],
      "autoApprove": [],
      "command": "uv",
      "disabled": false,
      "timeout": 60,
      "transportType": "stdio"
    }
  }
}

服务介绍

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: 播放次数。

    更多功能即将推出。

安装步骤

  1. 下载项目
git clone  https://github.com/video-creator/ffmpeg-mcp.git
cd ffmpeg-mcp
uv sync
  1. 在命令行中配置
{
  "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 架构。

查看源码 项目主页