适合谁
- 需要让 AI 代理在本地完成剪辑、加字幕、重制与质检的代理开发者
- 使用 Claude Code、Cursor 等 MCP 客户端的开发者与创作者
- 希望避免代理自己臆造 FFmpeg 参数、并需要可追溯产物的本地媒体工作者
K
66FMRS · C
Kinocut 是一个本地优先、Apache-2.0 许可的视频编辑 MCP 服务器，通过带类型检查的工具封装 FFmpeg，并提供预检护栏、Video Receipt 与质量/发布检查点，适合让 AI 代理在本地完成剪辑、加字幕、重制与质检。它的明显优势是免费、无需账号、媒体不出本机，且强调可审查与可追溯；代价是需要本机安装 FFmpeg（部分功能还需 Node.js 与较大的可选依赖），并且官方明确要求发布前必须做人工视听审核。README 中若干能力标注为未发布或受限状态，采用前应核对版本与状态说明。
Kinocut（曾用名 mcp-video）是一个免费、开源、本地优先的 Model Context Protocol 服务器，同时也提供 Python 客户端与 kino CLI。它把 FFmpeg（以及可选的 Hyperframes、Whisper 等扩展）封装为带类型检查的工具，配合预检护栏、Video Receipt（视频回执）校验与质量/发布检查点，让 AI 代理可以剪辑、加字幕、重制与质检本地视频，而不是自己臆造 FFmpeg 参数。根据 MCP 清单，该服务器通过 PyPI 包 kinocut 以 stdio 传输运行（uvx --from kinocut kino），许可证为 Apache-2.0。README 说明已发布版本 1.15.1 提供 196 个 MCP 工具与 167 个 CLI 命令，开发分支为 201 个 MCP 工具与 172 个 CLI 命令。它不需要 Kinocut 账号或 API 密钥，媒体文件不会上传到 Kinocut 云端，但要求本机已安装 FFmpeg 并在 PATH 中可用。注意：本仓库包含 2 个 MCP 服务器，本页仅介绍 server.json 对应的 Kinocut 服务器。
工具能力
video_intent
以意图动词表达编辑目标并生成干跑计划，不直接改动媒体文件
video_review_run
运行观看护栏基线检查，例如黑帧检测、LUFS 响度与首 15 秒检视
video_review_decide
对审查计划或 360 拼接方案做出人工决定（批准/拒绝）
video_ingest
把源素材导入私有的内容寻址项目空间
video_preflight
对已入库素材执行预检校验
video_inspect_temporal
对已入库素材执行时间维度检查并生成证据包
video_verdict
基于精确素材身份写出审查结论
video_acceptance_eval
评估验收条件与人工证据
video_body_swap
在保留音轨的前提下执行有界的画面替换等派生操作
video_salvage
按允许清单的修复方案对有问题的片段进行抢救式修复
video_workflow_validate
对多步骤工作流 job-spec 做低成本结构校验，不渲染
video_workflow_plan
生成干跑的操作图与哈希，不实际渲染
video_workflow_render
执行多步骤工作流并输出带来源追溯的回执
video_workflow_inspect
对工作流回执做只读完整性复核
video_composite_layers
按规格叠加多层图像/视频/色块，支持透明度、位置、遮罩与混合模式
video_repurpose
把一条源视频重制为竖版、横版、方形等交付包，含清单与审查产物
video_quality_check
对产物执行质量检查
video_release_checkpoint
生成发布检查点，包含缩略图与质量闸门
search_tools
按关键词发现可用工具，无需加载全部工具描述
安装接入
- 先安装 FFmpeg 并确保它在 PATH 中：macOS 用 brew install ffmpeg，Ubuntu/Debian 用 sudo apt install ffmpeg。2. 安装 Kinocut：pip install kinocut。3. 运行诊断：kino doctor，确认必需检查项通过。4. 在 MCP 客户端中注册服务器。Claude Code 可使用：claude mcp add kinocut -- uvx --from kinocut kino。Claude Desktop 或 Cursor 的配置文件示例：{"mcpServers":{"kinocut":{"command":"uvx","args":["--from","kinocut","kino"]}}}。5. 可选功能按需安装扩展，例如 pip install "kinocut[transcribe]"（语音转字幕，约 1 GB）。Hyperframes 相关工具还需要 Node.js 22 及以上版本以及可解析的 Hyperframes CLI。
claude_desktop_config.json
{
"mcpServers": {
"kinocut": {
"command": "uvx",
"args": ["--from", "kinocut", "kino"]
}
}
}
选型与风险
不适合谁
- 需要托管式云端编辑器或按量计费 SaaS 的用户
- 希望把 FFmpeg 当作无类型 shell 包装器自由执行任意命令的用户
- 不愿在本机安装 FFmpeg（以及可选 Node.js、Whisper 等依赖）的用户
- 期望直接处理 Insta360 .insv 或 GoPro .360 原始文件的人——必须先由相机应用导出为已拼接的等距柱状 MP4
所需权限
- 读写本地媒体文件与输出目录（编辑、导出与生成回执）
- 在本地执行 FFmpeg/ffprobe 子进程
- 读取与本机项目数据目录（例如 ~/.mcp-video 兼容数据目录）
- 可选：访问网络以使用 Hyperframes 相关能力、网页抓取或安装 Python 扩展依赖
- 可选：C2PA 签名需要 c2patool 及本地清单/签名配置
风险与副作用
- 代理可能生成不理想甚至不可用的视频：README 明确要求发布前执行视频质量检查与发布检查点，并进行人工视听审核
- 覆盖或写坏源素材的风险：抢救与衍生流程声称保持源文件不可变，但用户仍需自行备份重要媒体
- 可选扩展体积较大（转写约 1 GB、分轨约 2 GB、放大约 2 GB），会占用较多磁盘与安装时间
- 依赖本机外部工具链（FFmpeg，Hyperframes 场景还需 Node.js 22+），环境不一致会导致失败
- Hyperframes 的网页抓取、本地语音或 AI 去背等可选能力可能涉及网络访问与额外的许可/合规审查
- README 中部分能力（如桌面 MCPB 打包、Sonic World Audio 深层次集成、可信执行内核、生成式计划）仍处于未发布或受限状态，不应视为已可用的稳定功能
常见排障
- 先运行 kino doctor：它会报告哪些功能可用、缺少哪些依赖
- 确认 FFmpeg 已安装且在 PATH 中（brew install ffmpeg 或 sudo apt install ffmpeg）
- 若 MCP 模式启动失败，注意 1.15.0 起会打印真实导入原因而非笼统提示；检查 Python 版本是否满足 3.11+
- Hyperframes 工具需要 Node.js 22+ 以及可解析的 Hyperframes CLI，可通过 PATH 或 MCP_VIDEO_HYPERFRAMES_COMMAND 指定
- 缺少字幕转写、图像分析、分轨、放大等能力时，安装对应扩展，例如 pip install "kinocut[transcribe]"
- 首次验证可用最小流程：python scripts/golden_path.py，或运行仓库内 workflows/05-confidence-baseline 的置信基线工作流生成回执
- 从 mcp-video 迁移的用户可继续使用 mcp_video 导入、MCP_VIDEO_* 环境变量与旧回执字段；新集成建议使用 kinocut 与 kino 命令
使用场景
把一段访谈或播客剪成带字幕的竖版短片，并生成可供代理复跑、供人审阅的 Video Receipt
把一条母版视频重制为 YouTube Shorts、Instagram Reel、TikTok 等平台交付包，含缩略图、分镜与清单
播客与访谈剪辑：定位最精彩片段、统一响度、添加章节并导出
在 CI 或脚本中驱动可重复、可审查的媒体工作流（Claude Code、Cursor 等 MCP 客户端）
对损坏片段执行保留故事与时间线的抢救式修复，先诊断、只批准安全修复项，再渲染并验证
多帧图像/静帧包的整体调色与一致性闸门（still-match、still-grade、still-gate）
支持客户端
Claude Code完整支持
Claude Desktop完整支持
Cursor完整支持