使用说明

项目简介

FFmpeg-MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，它利用 FFmpeg 命令行工具，为 LLM 客户端提供本地视频处理能力。通过预定义的工具，用户可以通过自然语言指令，让 LLM 客户端调用服务器执行视频相关的操作，例如查找视频文件、获取视频信息、剪辑视频、拼接视频、播放视频以及视频叠加等。

主要功能点

视频文件查找: 根据目录和文件名查找视频文件路径。
视频信息获取: 获取视频文件的详细信息，如时长、帧率、编解码器等。
视频剪辑: 根据指定的时间范围或时长剪辑视频文件。
视频拼接: 将多个视频文件拼接成一个视频文件。
视频播放: 使用 ffplay 播放视频文件，支持多种格式和播放参数（速率、循环）。
视频叠加 (画中画): 将一个视频叠加到另一个视频之上，实现画中画效果。

安装步骤

下载项目:

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

注意: 确保已安装 'uv' 包管理器 (可以使用 'pip install uv' 安装)。

配置 Cline: 在 Cline (或其他 MCP 客户端) 的配置文件中添加以下 MCP 服务器配置：

{
  "mcpServers": {
    "ffmpeg-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ffmpeg-mcp",  //  请替换为 ffmpeg-mcp 项目的实际下载路径
        "run",
        "src/ffmpeg_mcp/server.py" //  指向 server.py 文件的路径
      ],
      "transportType": "stdio"
    }
  }
}

注意:

请将 '/path/to/ffmpeg-mcp' 替换为您实际下载 'ffmpeg-mcp' 仓库的本地路径。
'command' 指定了启动服务器的命令为 'uv'。
'args' 是一个字符串数组，包含了 'uv run' 命令的参数：
- '--directory': 指定工作目录为 'ffmpeg-mcp' 项目根目录。
- 'run': 'uv run' 命令，用于运行 Python 脚本。
- 'src/ffmpeg_mcp/server.py': 指定要运行的 Python 脚本为 'server.py'，该文件是 FFmpeg-MCP 服务器的入口点。
'transportType': 指定传输协议为 'stdio'。

基本使用方法

启动服务器: 在 Cline (或其他 MCP 客户端) 中启用名为 'ffmpeg-mcp' 的 MCP 服务器。Cline 将根据配置自动启动 'ffmpeg-mcp' 服务器。
通过 LLM 客户端与服务器交互:
- 使用支持 MCP 协议的 LLM 客户端，连接到 'ffmpeg-mcp' 服务器。
- 通过自然语言指令，指示 LLM 客户端调用服务器提供的工具。例如：
  - "请查找目录 '/Users/Videos' 下的视频文件 'my_movie.mp4'" (对应 'find_video_path' 工具)
  - "剪辑视频文件 '/Users/Videos/my_movie.mp4'，从 00:00:10 到 00:00:20" (对应 'clip_video' 工具)
  - "将 '/Users/Videos/video1.mp4' 和 '/Users/Videos/video2.mp4' 拼接成一个视频" (对应 'concat_videos' 工具)
  - "播放视频 '/Users/Videos/my_movie.mp4'，速度 1.5 倍" (对应 'play_video' 工具)
  - "将 '/Users/Videos/background.mp4' 和 '/Users/Videos/overlay.mp4' 叠加，输出为 '/Users/Videos/output.mp4'" (对应 'overlay_video' 工具)
查看结果: 服务器执行工具后，会将结果返回给 LLM 客户端，客户端根据返回结果进行后续处理或展示。例如，视频剪辑工具会返回剪辑后的视频文件路径。

注意:

当前版本仅支持 macOS 平台 (ARM64 或 x86_64)。
确保系统中已安装 FFmpeg 和 ffplay，并且 'ffmpeg' 和 'ffplay' 命令在系统 PATH 环境变量中可访问。仓库自带了 macOS 平台的 FFmpeg 和 ffplay 二进制文件，会自动下载和配置。

关键词

使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息