Video Editor MCP Server

视频编辑器 MCP 服务器

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

成分

工具

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

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

配置

先决条件

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

安装

1. 如果尚未安装，请安装 FFmpeg：
   # On macOS with Homebrew brew install ffmpeg # On Windows with Chocolatey choco install ffmpeg # On 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

发展

构建和发布

1. 同步依赖项：
   uv sync
2. 构建包：
   uv build
3. 发布到 PyPI：
   uv publish

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

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

调试

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

示例用法

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

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

服务器将：

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

错误处理

该服务器包括强大的错误处理功能：

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

所有错误都会连同详细的调试信息一起报告给客户端。

安全注意事项

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

贡献

欢迎贡献！请按以下步骤操作：

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