🚀 视频编辑 MCP 服务器
这是一个功能强大的视频编辑 MCP 服务器，它借助 FFmpeg，能通过自然语言命令来执行各类视频编辑操作，为用户提供便捷高效的视频处理体验。
✨ 主要特性
工具
本服务器实现了一个核心工具：
execute_ffmpeg：可执行带有进度跟踪的 FFmpeg 命令，具体功能如下：- 接收输入的命令字符串。
- 对 FFmpeg 操作进行验证并执行。
- 实时报告处理进度。
- 处理错误并提供详细反馈。
- 支持所有 FFmpeg 操作，包含：
- 裁剪/切割
- 合并视频
- 转换格式
- 调整速度
- 添加音频轨道
- 提取音频
- 添加字幕
- 基本滤镜（亮度、对比度等）
📦 安装指南
先决条件
- 需安装 FFmpeg 并确保其在系统 PATH 中可用。
- 需使用 Python 3.9 或更高版本。
- 安装所需的 Python 包：
mcp httpx
安装步骤
-
若未安装 FFmpeg，可按以下方式安装：
# 使用 Homebrew 在 macOS 上 brew install ffmpeg # 使用 Chocolatey 在 Windows 上 choco install ffmpeg # 在 Ubuntu/Debian 上 sudo apt install ffmpeg -
安装视频编辑包：
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，您可以使用自然语言进行如下请求：
- "将 video.mp4 从 1:30 到 2:45 裁剪"
- "将 input.mp4 转换为 WebM 格式"
- "将 video.mp4 加速 2 倍"
- "合并 video1.mp4 和 video2.mp4"
- "从 video.mp4 中提取音频"
- "将 subtitles.srt 添加到 video.mp4"
服务器会执行以下操作：
- 解析您的请求。
- 生成适当的 FFmpeg 命令。
- 执行命令并跟踪进度。
- 在完成时提供反馈。
📚 详细文档
开发
构建和发布
-
同步依赖项：
uv sync -
构建包：
uv build -
发布到 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 保护。