视频编辑MCP服务器

一个强大的视频编辑MCP服务器，通过自然语言命令利用FFmpeg执行视频编辑操作。

组件

工具

该服务器实现了一个主要工具：

• execute_ffmpeg: 执行带有进度跟踪的FFmpeg命令
  • 接受命令字符串作为输入
  • 验证并执行FFmpeg操作
  • 在处理过程中报告实时进度
  • 处理错误并提供详细反馈
  • 支持所有FFmpeg操作，包括：
    • 剪辑/切割
    • 合并视频
    • 转换格式
    • 调整速度
    • 添加音轨
    • 提取音频
    • 添加字幕
    • 基本滤镜（亮度、对比度等）

配置

先决条件

1. FFmpeg必须安装并在系统PATH中可访问
2. Python 3.9或更高版本
3. 必需的Python包：

   mcp
   httpx
   

安装

1. 如果尚未安装，请安装FFmpeg：

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

2. 安装视频编辑器包：

   uv add video-editor
   

Claude Desktop集成

在您的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"]
    }
  }
}

开发

构建与发布

1. 同步依赖项：

   uv sync
   

2. 构建包：

   uv build
   

3. 发布到PyPI：

   uv publish
   

注意：设置PyPI凭证：

• Token: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

为了获得最佳调试体验，请使用MCP Inspector：

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

示例用法

一旦连接到Claude Desktop，您可以发出如下自然语言请求：

1. "从1:30到2:45剪辑video.mp4"
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. 在完成时提供反馈

错误处理

服务器包含强大的错误处理机制，用于：

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

所有错误都会返回给客户端，并附带详细的调试信息。

安全考虑

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

贡献

欢迎贡献！请遵循以下步骤：

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 提交拉取请求