视频编辑器 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. 提交拉取请求