Kinocut

社区

面向 AI 代理的带护栏视频编辑 MCP 服务器

分类: 其他第 30 / 230
Stars: ★ 210 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.11+ · 预编译二进制 · Node.js 22+
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 7 天前
工具数: 19

66FMRS · C

Kinocut 是一个本地优先、Apache-2.0 许可的视频编辑 MCP 服务器，通过带类型检查的工具封装 FFmpeg，并提供预检护栏、Video Receipt 与质量/发布检查点，适合让 AI 代理在本地完成剪辑、加字幕、重制与质检。它的明显优势是免费、无需账号、媒体不出本机，且强调可审查与可追溯；代价是需要本机安装 FFmpeg（部分功能还需 Node.js 与较大的可选依赖），并且官方明确要求发布前必须做人工视听审核。README 中若干能力标注为未发布或受限状态，采用前应核对版本与状态说明。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

11/20

维护活跃度

15/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 静态材料显示该服务面向 stdio 本地运行，manifest 声明 PyPI 包 kinocut 1.15.1、runtimeHint 为 uvx，README 给出明确的 kino doctor 诊断、doctor 中的 mcp-server-import 检查、golden path 脚本和 receipts 机制，说明作者对启动失败和关键路径可诊断性有具体设计。但仅有 README 自述，未提供任何仓库内可核验内容：没有 CI 工作流文件、没有提交的测试用例、没有 server 端工具清单与实现的对照证据，声明为 196/201 个 MCP 工具却无法静态核实真实行为是否与描述一致。README 中版本号、日期与‘已发布/开发尖端’存在多处自我限定的不一致陈述，进一步增加不确定性。按静态校准原则，可靠性不得高于 12，故扣分至 10。
安全与权限 11/20: 该服务被描述为本地优先、媒体不上传云端、无需账号或 API 密钥，核心仅通过本地 FFmpeg 执行，高风险编辑路径声明有 preflight 守卫（滤镜边界、合并兼容、混音音量、不透明度、文字时序等），且发布/救援流程要求人工复核与 fail-closed，未发现凭据窃取、隐蔽外传、默认破坏性删除/支付/部署或伪造维护者身份等红线行为。但存在以下扣分点：一是需要 FFmpeg 在 PATH 上执行外部进程，README 未说明对输入路径与 FFmpeg 参数的白名单/沙箱边界；二是声明可选 C2PA 签名、Hyperframes/Node、Whisper 等 extras，会引入额外网络与依赖面，未见权限最小化说明；三是‘社区部署’示例引入 Tailscale Funnel、Caddy 与 Google OAuth，暴露面扩大但无安全评审证据；四是所有安全声明均为 README 自述，无可核验的权限/确认流程代码。综合为中等偏上，未触发红线，故给 11。
维护活跃度 15/20: manifest 与 README 显示 Apache-2.0 许可、当前版本 1.15.1、有明确的语义化版本与 CHANGELOG、CONTRIBUTING/CODE_OF_CONDUCT/GOVERNANCE/SECURITY/SUPPORT 等治理文件链接、列出多位具名外部贡献者及其 PR/Issue 编号，并声称有 CI（ci.yml 徽章）与发布流程，说明项目处于持续维护状态且所有权清晰。扣分点在于：这些治理与 CI 文件本身未包含在静态材料中，无法核实真实存在与内容；版本与发行日期（如 2026-08-31）在 README 中多处计数与状态互相限定，存在‘已发布/开发尖端’混用导致版本可追溯性偏弱；Security 响应渠道仅以链接形式出现，未见具体 SLA 或处理流程描述。故不给予高分，评 15。
文档质量 16/20: 文档层次丰富且具体：安装矩阵、Golden Path、Tutorial、COMPARE、RECOMMEND、TOOLS、PYTHON_CLIENT、CLI_REFERENCE、WORKFLOWS、RESCUE、360_ASSEMBLY、AI_VIDEO_*、MCPB、C2PA 等分门别类；README 提供 Claude Code/Desktop/Cursor 的配置示例、可选 extras 与体积说明、doctor 自检命令、工作流 JSON 与 receipt 示例，并显式披露限制（MCPB 非沙箱、.insv 不支持、生成式后端默认关闭、render 字节可能因 FFmpeg 构建而变）。扣分点：工具数量与版本在 README 中反复出现 196/201、167/172 的‘已发布 vs 开发尖端’双重口径，容易让读者误读当前能力；大量被引用的 docs/ 文件本身未包含在静态材料里，无法核验其内容与声明一致性；部分关键参数（工具入参细节、错误码）需跳转外部文档。按‘可用但有隐藏假设’档位评 16。
安装易用性 14/20: 安装路径清晰：先装 FFmpeg（给出 macOS/Ubuntu 命令），再加 pip install kinocut 或 uvx --from kinocut kino doctor，主流客户端（Claude Code 一行命令、Claude Desktop 与 Cursor 的 JSON 片段）均有可直接复制的配置；提供 extras 按需安装与体积提示、doctor 自检、启动失败的真实原因提示，跨平台声明支持 macOS/Linux/Windows，并说明 Hyperframes 需要 Node 22+。扣分点：依赖 FFmpeg 与 ffprobe 必须预先存在于 PATH，Windows 路径转义与 cp1252 控制台问题在 changelog 中反复出现，说明安装体验并非一次成功；MCPB 安装依赖已有 Node/Python/FFmpeg 且被明确标记为非沙箱；无 CI 或测试文件可静态验证上述步骤确实可行。按静态校准上限 15 与‘清晰但需人工准备运行时’档位评 14。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

需要让 AI 代理在本地完成剪辑、加字幕、重制与质检的代理开发者
使用 Claude Code、Cursor 等 MCP 客户端的开发者与创作者
希望避免代理自己臆造 FFmpeg 参数、并需要可追溯产物的本地媒体工作者

不适合谁

需要托管式云端编辑器或按量计费 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 深层次集成、可信执行内核、生成式计划）仍处于未发布或受限状态，不应视为已可用的稳定功能

安装接入

准备工作

运行环境：Python 3.11+ · 预编译二进制 · Node.js 22+

其他可选配置项（1 个）

MCP_VIDEO_HYPERFRAMES_COMMAND 可选指定 Hyperframes CLI 的可解析路径；仅在使用 Hyperframes 工具且 CLI 不在 PATH 上时需要设置。

先安装 FFmpeg 并确保它在 PATH 中：macOS 用 brew install ffmpeg，Ubuntu/Debian 用 sudo apt install ffmpeg。
安装 Kinocut：pip install kinocut。
运行诊断：kino doctor，确认必需检查项通过。
在 MCP 客户端中注册服务器。Claude Code 可使用：claude mcp add kinocut -- uvx --from kinocut kino。Claude Desktop 或 Cursor 的配置文件示例：{"mcpServers":{"kinocut":{"command":"uvx","args":["--from","kinocut","kino"]}}}。
可选功能按需安装扩展，例如 pip install "kinocut[transcribe]"（语音转字幕，约 1 GB）。Hyperframes 相关工具还需要 Node.js 22 及以上版本以及可解析的 Hyperframes CLI。

.mcp.json

{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": ["--from", "kinocut", "kino"]
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "kinocut": {
      "command": "uvx",
      "args": [
        "--from",
        "kinocut",
        "kino"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add kinocut -- uvx --from kinocut kino

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后运行 `uvx --from kinocut kino doctor`（必需检查应通过）；在 Claude Code 中执行 `claude mcp add kinocut -- uvx --from kinocut kino`，然后向 agent 询问可用工具，应能看到 video_intent、video_repurpose、search_tools 等工具。

常见排障

先运行 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 命令

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把这段采访剪成最强的45秒，加上烧录字幕，变成竖屏，并在导出前做质量检查。
把这个横屏录制转成带字幕的 TikTok 短视频和 YouTube Short。
把 master 视频转成 Shorts、Reels、TikTok 的本地交付包，带缩略图和清单。
用 trim、add_text、normalize_audio、resize 的 pipeline 生成一个竖屏短视频，并输出 Video Receipt。

工具能力 19

video_intent 只读

以意图动词表达编辑目标并生成干跑计划，不直接改动媒体文件

video_review_run 只读

运行观看护栏基线检查，例如黑帧检测、LUFS 响度与首 15 秒检视

video_review_decide 写入

对审查计划或 360 拼接方案做出人工决定（批准/拒绝）

video_ingest 写入

把源素材导入私有的内容寻址项目空间

video_preflight 只读

对已入库素材执行预检校验

video_inspect_temporal 只读

对已入库素材执行时间维度检查并生成证据包

video_verdict 写入

基于精确素材身份写出审查结论

video_acceptance_eval 只读

评估验收条件与人工证据

展开其余 11 个工具

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 只读

按关键词发现可用工具，无需加载全部工具描述

使用场景

把一段访谈或播客剪成带字幕的竖版短片，并生成可供代理复跑、供人审阅的 Video Receipt

把一条母版视频重制为 YouTube Shorts、Instagram Reel、TikTok 等平台交付包，含缩略图、分镜与清单

播客与访谈剪辑：定位最精彩片段、统一响度、添加章节并导出

在 CI 或脚本中驱动可重复、可审查的媒体工作流（Claude Code、Cursor 等 MCP 客户端）

对损坏片段执行保留故事与时间线的抢救式修复，先诊断、只批准安全修复项，再渲染并验证

多帧图像/静帧包的整体调色与一致性闸门（still-match、still-grade、still-gate）

支持客户端

Claude Code

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

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 服务器。