Cutbolt video editing engine

Cutbolt

Cutbolt 是一款面向 AI Agent 的本地视频编辑引擎。将录制的素材剪辑成成片：安排镜头、精简对话、添加字幕和图形、混音并导出。每次保存的剪辑都有一个修订版本，因此 Agent 可以检查更改、重试请求或撤销操作。

可通过 JSON 命令、Rust 库或基于 stdio 的 MCP 使用。引擎在你的设备上运行，会保留源媒体，且无需账户或托管服务。

• 适用对象： 将录制素材（采访、对镜讲话、教程、屏幕录制和演示文稿）制作成成片，并希望 Claude Code 或其他 MCP Agent 在自己的设备上完成剪辑的人。
• 适用于以下场景： 希望 Agent 精确地剪辑、添加字幕、混音并导出真实素材，同时可以检查、重试或撤销它执行的每项更改。
• 不适用于以下场景： 希望在可视化时间线上手动剪辑（Cutbolt 由 Agent、JSON 命令或 Rust 库驱动）、需要托管或云服务、希望通过文本提示词生成新视频（它编辑的是你已有的素材），或需要超出其文档所述限制的格式（参见当前范围）。
• 与 Kinocut（原名 mcp-video）、claudeclip、video-edit-mcp、Video Jungle MCP、Vlexor 和 HyperFrames 相比： 参见面向 AI Agent 的本地视频编辑 MCP 服务及托管替代方案：7 款对比（检查日期：2026 年 10 月 17 日）：Cutbolt 的数据通过 MCP 测得（帧精确剪切、安全重试、撤销，以及在同一 FFmpeg 构建版本上生成字节完全相同的重复导出结果）；其他工具则根据其代码和文档进行评估，并介绍了各自的适用场景。

可以制作的内容

• 采访和对镜讲话： 按时间或转录文本剪辑、缩短停顿、在同步摄像机之间切换，并添加定时字幕。
• 教程和录制的演示文稿： 组合屏幕录制、摄像机素材、标题和叠加内容；导出前预览单帧或指定片段。
• 多层剪辑： 安排视频和音频轨道、重复使用嵌套序列，并将变换、蒙版、颜色调整和转场与项目一同保存。
• 成片交付： 混音并测量音频、导出无损母版或 H.264 视频、检查结果，并通过 OTIO 交付受支持的时间线。
• 可重复的工作流： 保留修订版本、请求回执和撤销历史；恢复本地渲染任务，并修改制作中的单个部分。

符合条件的 H.264 和 HEVC 素材可直接编辑。其他受支持的源素材会在排队导出时自动准备。标题、图形和字幕可以作为可编辑的场景配方保留在时间线上。可选的语音识别和媒体工作进程可在本地运行，但需单独安装依赖项。

开始使用

Cutbolt 正在开发中。目前的验证平台是 Windows 和 Linux。每次安装都需要将 FFmpeg 和 ffprobe 加入 PATH，或将 CUTBOLT_FFMPEG 和 CUTBOLT_FFPROBE 设为它们的路径；Cutbolt 不会捆绑这两者。

预编译版本（早期发布）：最新发布版本包含适用于 Windows x64、Linux x64 和 macOS ARM64 的 CLI（macOS 不是验证平台：MCP 导出所经过的后台作业需要 Windows 或 Linux，且仅限 Windows 的引擎功能仍然只能在 Windows 上使用），以及 cutbolt-windows-x64.mcpb，这是供 Windows 上 Claude Desktop 使用的 MCP bundle。请使用 SHA256SUMS 检查下载文件。Cutbolt 已列入官方 MCP Registry，名称为 io.github.skulitom/cutbolt。

**从源代码安装，**需要 Rust 和 C 构建工具链，并在本仓库的检出目录中执行：

cargo install --path . --locked
cutbolt --version
cutbolt doctor

为素材和输出创建单独的工作区，然后将 Agent 的 MCP 客户端配置为启动：

cutbolt --workspace /absolute/path/to/workspace mcp

将路径替换为你的工作区目录；在 Windows 上，请使用类似 C:\Videos\MyProject 的路径。默认 MCP 目录较为精简，需要时可按需获取详细命令。

有关先决条件、配置和可选 Claude Code 插件，请参阅安装和客户端设置。该插件包含用于重新剪辑、教程、多机位剪辑、字幕和交付的配方。其他 Agent 可以从 llms.txt 开始。

如果要使用 Claude Code 插件，而不是手动配置客户端，请从 GitHub 添加插件：

claude plugin marketplace add skulitom/Cutbolt
claude plugin install cutbolt@cutbolt-local

然后在你的素材工作区中重启 Claude Code。该插件会从 PATH 启动 cutbolt，自身不会安装任何内容。插件的配方跟随 main 分支，该分支可能领先于预编译版本，因此请为插件安装 CLI 的源代码版本：如上所述，或通过 cargo install --git https://github.com/skulitom/Cutbolt --locked 安装。

连接后，可以尝试以下请求：

检查此工作区中的素材，将第一个片段修剪为开头十秒，并为我显示预览。保存此次编辑，以便我稍后修改。

如需直接使用 CLI，使用指南介绍了 JSON 请求和已保存项目。Agent 接口介绍了修订、重试、作业和工作区边界。

当前范围

0.4.0 版是一个正在积极开发的引擎。支持的格式和操作都有明确限制；时间线默认使用 8 位 SDR 处理。有关当前约定，请参阅直接素材、片段效果、生成的片段和导出格式。

验证会根据独立预期检查解码后的画面、音频样本、时序和已保存编辑的行为。已发布的验证证据记录了最近一次完整验收运行；进度历史记录了后续变更、针对性检查和未完成工作。Agent 工作流测量和素材基准测试结果介绍了测试任务及其限制。

开发与许可证

有关实现和规划的详情，请参阅开发工作流、架构和 1.0 路线图。

原始项目代码采用 MIT 许可证。外部依赖保留各自的许可证；经过测试的版本和要求列于依赖清单。仓库材料和署名规则记录在研究与发布边界中。

同系列工具

Cutbolt 是同一作者为 Agent 开发的五款免费、采用 MIT 许可证的工具之一。每款工具都会在本地作为 MCP 服务运行：

• Anode：在隐藏的后台会话中自动化操作 Windows 桌面，让 Agent 无需接管屏幕即可点击、输入和截取屏幕截图。
• Pixelbolt：使用可编辑的 JSON 配方制作像素艺术和精灵动画，并导出为精灵图集、图集、动态 PNG 和 GIF。
• Inkbolt：用于编辑示意图和插画的矢量与光栅图像工具，支持导入 SVG、PNG、JPEG 和 TIFF，以及导出 SVG 和 PDF。
• Nestbolt：用于激光、CNC、等离子和水刀切割的板材零件二维排样，也可在浏览器中使用。