使用说明

项目简介

Video Editor MCP Server 是一款基于 Model Context Protocol (MCP) 构建的应用后端，它利用强大的 FFmpeg 工具，为 LLM 客户端提供视频编辑能力。通过自然语言指令，用户可以让 LLM 客户端（如 Claude Desktop）调用此服务器，执行各种视频编辑任务。

主要功能点

FFmpeg 命令执行: 支持执行各种 FFmpeg 命令，实现丰富的视频编辑功能。
- 视频剪辑/裁剪
- 视频合并
- 视频格式转换
- 视频速度调整
- 添加音轨
- 音频提取
- 添加字幕
- 基础滤镜 (亮度、对比度等)
实时进度跟踪: 在执行 FFmpeg 命令时，实时报告处理进度。
错误处理: 提供完善的错误处理机制，当出现错误时，返回详细的错误信息，方便调试。
安全考虑: 限制文件访问路径，验证 FFmpeg 命令，确保操作安全。
Claude Desktop 集成: 可以方便地集成到 Claude Desktop 等 MCP 客户端。

安装步骤

安装 FFmpeg: 确保你的系统已安装 FFmpeg，并已将其添加到系统 PATH 环境变量中。
- macOS (Homebrew): 'brew install ffmpeg'
- Windows (Chocolatey): 'choco install ffmpeg'
- Ubuntu/Debian: 'sudo apt install ffmpeg'
安装 Video Editor MCP Server: 使用 'uv' 包管理器安装 'video-editor' 包。
```
uv add video-editor
```
注意: 'uv' 是一个 Python 包管理工具。如果你的环境中没有安装 'uv'，请先安装 'uv' 或将其替换为你常用的 Python 包管理工具（如 'pip'），并使用相应的安装命令。

服务器配置

要将 Video Editor MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要配置客户端的 MCP 服务器设置。以 Claude Desktop 为例，你需要编辑其配置文件 'claude_desktop_config.json'，添加以下服务器配置信息：

配置信息 (JSON 格式):

{
  "mcpServers": {
    "video-editor": {
      "command": "uv",
      "args": ["run", "video-editor"]
    }
  }
}

参数说明:

'server name': 服务器名称，这里设置为 'video-editor'，可以自定义。
'command': 启动服务器的命令，这里使用 'uv' 命令。
'args': 启动服务器命令的参数，这里使用 'run video-editor'，表示运行 'video-editor' 包。

基本使用方法

配置完成后，在 MCP 客户端（如 Claude Desktop）中，你可以使用自然语言指令来指示 LLM 调用 Video Editor MCP Server 进行视频编辑。例如：

"剪辑 video.mp4，从 1 分 30 秒到 2 分 45 秒"
"将 input.mp4 转换为 WebM 格式"
"将 video.mp4 速度加快 2 倍"
"合并 video1.mp4 和 video2.mp4"
"从 video.mp4 中提取音频"
"为 video.mp4 添加 subtitles.srt 字幕"

服务器将解析你的指令，生成相应的 FFmpeg 命令并执行，然后将结果返回给客户端。

关键词