Featured image of post 让 Claude 剪片:Hermes 与 Claude Code 接入剪映/Premiere MCP 的实战配置

让 Claude 剪片:Hermes 与 Claude Code 接入剪映/Premiere MCP 的实战配置

cutcli、jianying-mcp、capcut-mcp、OpenChatCut、Adobe Premiere Pro MCP 五条路线的安装配置与代码,把视频剪辑从手动拖轨道变成一句话下指令,含完整的 Hermes config.yaml 和 Claude Code mcp.json 示例

前两篇拆完了 AI 短剧的生成侧(LibTV 制作链路、开源替代项目),但片子生成后还有一关:剪辑。分镜素材、配音、字幕、BGM、转场,传统做法是在剪映里手动拖几小时。

2026 年这条链路也可以交给 agent 了。本文给出五条已经跑通的 MCP 路线,附完整配置代码,Hermes 和 Claude Code 都能用。

先看全景:五条路线怎么选

路线原理星数/状态适合谁
cutcliCLI 生成剪映草稿文件★195 / v1.3.9 活跃想用脚本批量出片
jianying-mcpMCP 封装 pyJianYingDraft★293要精细控制轨道/关键帧
capcut-mcpHTTP API + MCP 双协议★96Cursor/Claude HTTP 接入
OpenChatCut开源 ChatCut,agent 原生编辑器★1949 / 高频更新要可视化 + agent 双模
Premiere Pro MCPCEP 桥接 283 个工具★593 / MITPR 用户、专业后期

共同原理只有一句话:这些工具都不渲染视频,它们生成"剪映/PR 能打开的工程文件"或直接操纵已打开的工程。渲染和最终导出还是宿主软件做,AI 负责"搭积木"。

路线一:cutcli——脚本生成剪映草稿,最干净

cutcli(cookbook 在 xuliang2024/cutcli-cookbook)是 CapCut/剪映的草稿 CLI:一行命令创建草稿、加素材、上字幕,生成的草稿直接出现在剪映桌面版的草稿列表里,所见即所得可继续手改。

1
2
3
4
5
6
7
8
# 安装
curl -s https://cutcli.com/cli | bash

# 跑通第一个例子
git clone https://github.com/xuliang2024/cutcli-cookbook.git
cd cutcli-cookbook/examples/01-hello-caption
bash run.sh
# 打开剪映——新草稿已经在列表里

它对 agent 的友好度是五个里最高的。cookbook 的 prompts/claude/ 目录直接提供 Claude Code 系统提示词,核心思路是让模型扮演两个角色:

  1. 先当分镜师:输出镜号/时段/画面/字幕/音乐/转场的 markdown 表
  2. 再当 cutcli 工程师:把表翻译成 run.sh——时间用整数微秒、复杂 JSON 拆到 data/*.json、每个 add 命令前加注释、DRAFT_ID=$(cutcli draft create ... | jq -r '.draftId') 串起流程

素材名不用猜,有查询命令兜底:

1
2
3
cutcli query text-animations --type in      # 字幕动画名
cutcli query transitions --action search --keyword 推近
cutcli query filters --action search --keyword 暖色

cookbook 还有 30+ 个 JSON 模板(vlog、产品宣传、字幕卡)和 v1.3.9 的云渲染能力,MIT 许可。

路线二:jianying-mcp——要关键帧和特效粒度就用它

hey-jian-wei/jianying-mcp(Apache-2.0,Python 3.13+)把 pyJianYingDraft 封装成标准 MCP server,工具粒度极细:add_video_keyframe(关键帧动画)、add_video_mask(蒙版)、add_text_bubble(字幕气泡)、find_effects_by_type(枚举可用特效)……

安装与 Claude 接入(uv 方式,官方 README 原样):

1
2
3
4
5
6
# 装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆并装依赖
git clone https://github.com/hey-jian-wei/jianying-mcp.git
cd jianying-mcp && uv sync

MCP 客户端配置(Claude Code 的 ~/.claude.json 或 Hermes 的 config,见下文):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "mcpServers": {
    "jianying-mcp": {
      "command": "uv",
      "args": ["--directory", "/your-path/jianying-mcp/jianyingdraft", "run", "server.py"],
      "env": {
        "SAVE_PATH": "/your-path/draft",
        "OUTPUT_PATH": "/your-path/output"
      }
    }
  }
}

它甚至内置 rules 工具——“制作视频规范”,让 agent 每次先读规范再动手,这是把剪辑经验固化进 MCP 的聪明做法。

路线三:capcut-mcp——HTTP 接口,剪映中国版/国际版通吃

fancyboi999/capcut-mcp 走 HTTP 路线:本机起服务(默认 9000 端口),暴露 /create_draft、/add_video、/add_subtitle、/add_effect、/save_draft 等接口,同时挂 MCP 端点。国内版剪映和国际版 CapCut 的草稿格式都支持。

Claude 侧配置极简:

1
2
3
4
5
6
7
8
{
  "mcpServers": {
    "capcut-mcp": {
      "type": "http",
      "url": "http://localhost:9000/mcp"
    }
  }
}

HTTP 协议意味着不止 MCP 客户端能用——curl 脚本、n8n 工作流、你自己的 Python 管线都能直接调,适合把它当"剪辑后端"嵌进自动化系统。

路线四:OpenChatCut——想要"AI 版剪映"本体

0xsline/OpenChatCut(★1949,活跃开发)是另一个物种:完整的开源视频编辑器(React 19 + Remotion 4 + Electron 43,多轨时间线),同时agent 原生——Codex、Claude Code、内置 agent 都能读、编、导出工程,且工程保持完全可编辑。

接入 Claude Code 只要一条命令装 skill:

1
npx skills add 0xsline/OpenChatCut

然后对 agent 说 Set up OpenChatCut。它暴露 Streamable HTTP MCP 端点(http://localhost:5199/api/external-mcp/mcp),根目录 .mcp.json 已含本地连接。

设计上最值得学的是编辑会话机制:

  1. begin_edit_session 拿到 editSessionId
  2. 后续所有读写都带这个 id,改动只落在隔离草稿上
  3. review_edit_session 提交审查
  4. manual 模式下人工在编辑器里预览、批准或拒绝;auto 模式立即生效

AI 改坏了不会污染原工程,回滚粒度是"一次提案"。对生产环境这是关键护栏。自定义 skill 放 ~/.openchatcut/skills/<slug>/SKILL.md,与 Claude/Codex 的 skill 目录同构。

路线五:Premiere Pro MCP——PR 用户的专业后期

hetpatel-11/Adobe_Premiere_Pro_MCP(MIT,npm 包)通过 CEP 面板桥接本地 Premiere,暴露 283 个工具(藏在 search_tools/invoke_tool 两个入口后面)+ 13 个资源 + 10 个引导提示。时间线编辑、调色、音频全覆盖。

1
2
3
4
npm install -g adobe-premiere-pro-mcp
premiere-pro-mcp --install-cep    # 装 CEP 桥 + 配置 MCP 客户端
premiere-pro-mcp --doctor         # 自检
# 重启 PR → Window > Extensions > MCP Bridge (CEP) → 启动桥

Claude Code 有官方插件路径:

1
2
/plugin marketplace add .
/plugin install premiere-pro-mcp@adobe-premiere-pro-mcp

对 Codex 同理(codex plugin marketplace add .)。验证连接就一句话:让 Claude 跑 verify_premiere_connection。注意三件套(PR、MCP 客户端、本包)必须在同一台机器,UXP 桥还是实验性,生产用 CEP。

Hermes 这边怎么接

Hermes Agent 原生支持 MCP server,配置在 ~/.hermes/config.yaml 的 mcp_servers 键下,两种传输都支持。以 jianying-mcp(stdio)和 capcut-mcp(HTTP)为例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
mcp_servers:
  jianying:
    command: "uv"
    args: ["--directory", "/home/you/jianying-mcp/jianyingdraft", "run", "server.py"]
    env:
      SAVE_PATH: "/home/you/draft"
      OUTPUT_PATH: "/home/you/output"
    timeout: 180
  capcut:
    url: "http://localhost:9000/mcp"
    timeout: 180

改完重启 Hermes,工具会以 mcp_jianying_*、mcp_capcut_* 前缀注册进所有平台工具集。之后在对话里说"把 /videos 下的分镜按分镜表剪成 60 秒竖屏、字幕用白底黑字气泡"就是一条可执行的指令。

Claude Code 侧对应写进 .mcp.json(JSON 格式同上文各示例),项目级放仓库根、全局放 ~/.claude.json。

我推荐的组合拳

接上篇的短剧产线,最小手动量的分工是:

  1. 素材层:Toonflow/LocalMiniDrama 生成角色、场景、分镜视频(上篇)
  2. 结构层:Claude Code + cutcli——从剧本自动出分镜表、翻译成 run.sh、批量落草稿
  3. 精修层:草稿在剪映里打开,人只做三件事:抽卡挑片、听配音节奏、调转场手感
  4. 导出层:cutcli v1.3.9 云渲染或剪映导出

把"拖轨道"这种机械劳动全部下沉给 agent,人的时间花在审美决策上。按分镜师表的行列数估算,一条 20 镜头的竖屏短片,手动剪辑约 2 小时的活压到 10 分钟审查 + 少量手改。

两个实操提醒:草稿路径用绝对路径,剪映对相对路径的解析经常和 agent 的工作目录不一致;add_video_segment 的时长单位是微秒,Claude 偶尔会写成毫秒,第一次跑通后让它自检一遍单位换算。

数据与考证

五条路线的安装命令、配置片段、会话机制描述均摘自各项目官方 README 与 docs(GitHub API 拉取,2026-09-21 核对)。星数:cutcli-cookbook ★195、jianying-mcp ★293、capcut-mcp ★96、OpenChatCut ★1949、Premiere Pro MCP ★593。Hermes 的 mcp_servers 配置格式来自 Hermes Agent 官方文档。