vedit-mcp · 让 AI 替你剪视频的 MCP 非线性编辑器 Skill 技能

技能简介

vedit-mcp 是一款通过 Model Context Protocol（MCP）让 AI 直接驱动的非线性视频编辑器。它提供完整的时间线、片段、剪切、转场与导出的视频编辑能力，同时通过 MCP 把这些能力开放给任何兼容客户端（Claude Desktop、Cursor、VS Code Continue、OpenAI Agent 等）。你只需要用自然语言说出想要的剪辑效果——「把前 12 秒切掉，在第 18 秒加一个淡入转场，把 BGM 静音」——AI 会边做边把片段在时间线上拖给你看，期间你可以随时抓过鼠标做手动修正。底层使用 ffmpeg + Python 标准库 + numpy + Pillow，无重型依赖。

核心能力

• MCP 原生集成：暴露标准 tools/list 与 resources/read，Claude、Cursor、Cline 等客户端即插即用
• 真实时间线编辑器：不仅生成指令，还会直接把片段在 UI 时间线上拖动，所见即所得
• 鼠标随时接管：AI 操作过程中，任何时刻都可以抓过鼠标手动覆盖单帧、单个转场或某段音频
• ffmpeg 渲染管线：内置基于 ffmpeg 的导出流水线，支持主流编码（h264/h265、ProRes、VP9）与字幕烧录
• 结构化剪辑原语：切割、拼接、转场（淡入淡出、交叉溶解、滑动）、调速、音轨替换、字幕轨道独立
• 可观测操作日志：每次 AI 编辑都生成结构化日志（cut/transition/speed），便于回滚和审计
• Python 包 + Web UI 双形态：既可作为 MCP 服务器以 CLI 启动，也提供 Web UI 实时观察编辑进度

安装配置

• 通过 pip install vedit-mcp 安装（需 Python ≥ 3.10）
• 安装 ffmpeg 二进制并加入 PATH（macOS 用 brew、Linux 用 apt/conda）
• 在 MCP 客户端配置文件（claude_desktop_config.json / Cursor MCP settings）中添加：

  {"mcpServers": {"vedit": {"command": "vedit-mcp", "args": ["--workspace", "/path/to/clips"]}}}

• Web UI 模式：vedit-mcp ui --port 7860，浏览器打开查看时间线与剪辑日志

使用步骤

1. 用 pip install vedit-mcp 安装包，并用 vedit-mcp init 在当前目录生成默认工作区与素材目录结构
2. 把原始视频片段（mp4/mov）拖进 clips/ 目录，脚本会自动索引时长与分辨率
3. 在 MCP 客户端（Claude Desktop / Cursor）中打开本项目目录，输入剪辑指令：「把这三段素材剪成 60 秒 vlog，前两段加交叉溶解，最后加 2 秒黑场」
4. AI 会自动操作时间线：拖入片段、添加转场、设置导出参数；过程中 Web UI 实时刷新显示
5. 你随时可以暂停 AI 并直接拖动时间线、做手动微调；微调结果会写入同一份编辑日志
6. 在 Web UI 顶部点「导出」选择编码、分辨率与字幕烧录，调用 ffmpeg 输出成片
7. 完成后可以在 edits/ 目录看到每次 AI 操作的 JSON 日志，用于回滚或训练剪辑偏好

适用场景

• 短视频创作者（抖音 / Reels / Shorts）批量产出多版本剪辑
• Vlog 后期粗剪，让 AI 砍掉废段后再人工精修
• 教学视频按大纲自动分段、加字幕和转场
• 播客视频化：音频 + 静态图自动加上节奏化切换
• 企业内训与发布会素材快速生成多版本短片
• 内容运营 A/B 测试同一素材的不同剪辑节奏

适用人群

独立视频创作者、内容运营团队、MCN 后期、播客制作人，以及希望把剪辑流程交给 AI 但又不愿意完全放手的关键节点创作者。

工作原理

vedit-mcp 把视频编辑抽象成一颗操作树（Operation Tree）：每个动作（cut / join / transition / speed / audio swap）都是一个带 UUID 的原子节点，AI 通过 MCP 工具调用在这棵树上挂节点；UI 层订阅事件流并实时渲染时间线。底层调用 ffmpeg 做实际编码，Python 端维护「声明式项目状态」与「ffmpeg 命令序列」之间的映射。这种设计的优点是：AI 可以在任意步骤撤销/重做（修改操作树即可），UI 与 AI 看到的是同一份事实，避免「AI 说剪了但 UI 没动」的同步问题。

官方链接

• PyPI: https://pypi.org/project/vedit-mcp/
• GitHub: https://github.com/metiutek/editorvideo-ai
• Issues: https://github.com/metiutek/editorvideo-ai/issues
• License: MIT