🚀 视频编辑 MCP 服务器

这是一个功能强大的视频编辑 MCP 服务器，它借助 FFmpeg，能够依据自然语言命令来执行各类视频编辑操作，为视频处理带来极大便利。

✨ 主要特性

工具

该服务器实现了一个关键工具：

• execute_ffmpeg：可执行带有进度跟踪的 FFmpeg 命令。
  • 接收输入的命令字符串。
  • 对 FFmpeg 操作进行验证并执行。
  • 实时报告处理进度。
  • 处理错误并给出详细反馈。
  • 支持所有 FFmpeg 操作，涵盖：
    • 裁剪/切割
    • 合并视频
    • 转换格式
    • 调整速度
    • 添加音频轨道
    • 提取音频
    • 添加字幕
    • 基本滤镜（亮度、对比度等）

📦 安装指南

先决条件

1. 必须安装 FFmpeg 并确保其在系统 PATH 中可用。
2. 需要 Python 3.9 或更高版本。
3. 所需的 Python 包：

   mcp
   httpx
   

安装步骤

1. 若未安装 FFmpeg，可按以下方式安装：

   # 使用 Homebrew 在 macOS 上
   brew install ffmpeg
   
   # 使用 Chocolatey 在 Windows 上
   choco install ffmpeg
   
   # 在 Ubuntu/Debian 上
   sudo apt install ffmpeg
   

2. 安装视频编辑包：

   uv add video-editor
   

Claude 桌面集成

在您的 Claude Desktop 配置文件中进行如下配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

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

💻 使用示例

一旦连接到 Claude Desktop，您就可以通过自然语言进行请求，示例如下：

1. "将 video.mp4 从 1:30 到 2:45 裁剪"
2. "将 input.mp4 转换为 WebM 格式"
3. "将 video.mp4 加速 2 倍"
4. "合并 video1.mp4 和 video2.mp4"
5. "从 video.mp4 中提取音频"
6. "将 subtitles.srt 添加到 video.mp4"

服务器会执行以下操作：

1. 解析您的请求。
2. 生成合适的 FFmpeg 命令。
3. 执行命令并跟踪进度。
4. 在完成时提供反馈。

📚 详细文档

开发

构建和发布

1. 同步依赖项：

   uv sync
   

2. 构建包：

   uv build
   

3. 发布到 PyPI：

   uv publish
   

注意：可通过以下方式设置 PyPI 凭证：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

使用 MCP 检查器可获得最佳调试体验：

npx @modelcontextprotocol/inspector uv --directory /path/to/video_editor run video-editor

错误处理

服务器具备健壮的错误处理功能，可处理以下情况：

• 输入文件无效
• FFmpeg 命令格式不正确
• 执行时错误
• 进度跟踪问题

所有错误都会详细报告给客户端，方便调试。

安全注意事项

• 仅处理明确定义允许目录中的文件。
• 在执行 FFmpeg 命令前进行验证。
• 对所有输入参数进行清理。
• 报告详细的与安全相关问题的错误消息。

贡献

我们欢迎您为这个项目做出贡献！请查看我们的 贡献指南 以获取详细信息。

📄 许可证

此项目受 MIT License 保护。