关于 CartCut
CartCut MCP 是 CartCut 桌面视频编辑器的 MCP 桥接包,让 Claude 等 MCP 客户端直接编辑用户当前打开的项目。它以 stdio 方式运行并转发到应用内的 MCP 服务,编辑操作可通过 CartCut 自身的撤销历史回退。
主要功能
- 01基于文字稿进行剪辑
- 02添加字幕
- 03裁剪与重新排列片段
- 04添加动效、转场与效果
- 05编辑操作可通过应用撤销
适用场景
- 01让 Claude 根据文字稿剪掉停顿或错误片段
- 02为已打开的视频项目批量添加字幕
- 03调整片段顺序并添加转场效果
MCP 相关
该包是 MCP 服务的 stdio 桥接端,客户端通过 npx 启动它,它再将消息转发到 CartCut 内置的 MCP 服务(http://127.0.0.1:9826/mcp)。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@cartesiancs/cartcut-mcp
将 Claude 及其他 MCP 客户端连接到你电脑上运行的 CartCut 视频编辑器。Claude 可以编辑你当前打开的项目:根据转录内容剪辑、添加字幕、修剪并重新排列片段,以及添加运动效果、转场和特效。所有编辑都会记录在 CartCut 自己的撤销历史中,因此按 ⌘Z 即可撤销。
CartCut 在应用内运行 MCP 服务,地址为 http://127.0.0.1:9826/mcp。此软件包负责连接中的 stdio 部分:客户端启动它,它再将每条消息转发给应用并传回。无需配置:它会从 CartCut 自己的设置中读取令牌。
要求
- CartCut 已打开。在此处下载。
- Node.js 18 或更高版本,用于运行
npx。
安装
Claude Code
claude mcp add cartcut -- npx -y @cartesiancs/cartcut-mcp
添加 -s user,即可在每个项目中使用。若要同时安装编辑技能——它能让 Claude 成为出色的编辑器,而不只是拥有这些工具——请改为安装插件:
plugins/cartcut-editing。
如果未安装该技能,桥接程序会告知 Claude 去哪里查阅。
Claude Desktop、Cursor 和其他客户端
{
"mcpServers": {
"cartcut": {
"command": "npx",
"args": ["-y", "@cartesiancs/cartcut-mcp"]
}
}
}
Codex
codex mcp add cartcut -- npx -y @cartesiancs/cartcut-mcp
配置
两个变量均为可选。
| 变量 | 默认值 | |
|---|---|---|
CARTCUT_MCP_TOKEN | 从 CartCut 的设置中读取 | 位于 CartCut 窗口右下角 ⚡ 图标下方的令牌。 |
CARTCUT_MCP_URL | http://127.0.0.1:9826/mcp | CartCut 监听的地址。 |
如果未设置 CARTCUT_MCP_TOKEN,令牌将从 CartCut 的 config.json 中读取:
- macOS:
~/Library/Application Support/cartcut-app/config.json - Windows:
%APPDATA%\cartcut-app\config.json - Linux:
~/.config/cartcut-app/config.json
值得了解的行为
**CartCut 可以在会话期间重启。**退出并更新 CartCut,然后重新打开:下次调用时会与应用建立新会话并继续操作,同时会通知客户端重新读取工具列表。
**调用绝不会发送两次。**如果 CartCut 在工具调用运行期间关闭,调用会返回错误,而不会重试,因为它可能已经更改了时间线。再次发出请求前,请先查看编辑器。
**没有任何内容会离开本机。**桥接程序只会与上述地址通信。
故障排除
- “CartCut 未运行,或其 MCP 桥接已关闭”:打开 CartCut,然后重新连接(在 Claude Code 中输入
/mcp)。 - “CartCut 拒绝了令牌”:
CARTCUT_MCP_TOKEN设置的是旧令牌。取消设置,或从 ⚡ 图标处复制当前令牌。 - “没有 CartCut 令牌”:此账户从未打开过 CartCut。打开一次即可。
运行 npx -y @cartesiancs/cartcut-mcp --version 可查看版本。桥接程序将日志写入 stderr,绝不会写入承载协议的 stdout。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。