mcpField
C
CartCut

CartCut

本地服务
cartesiancs.com媒体与设计8181 天前更新

关于 CartCut

CartCut MCP 是 CartCut 桌面视频编辑器的 MCP 桥接包,让 Claude 等 MCP 客户端直接编辑用户当前打开的项目。它以 stdio 方式运行并转发到应用内的 MCP 服务,编辑操作可通过 CartCut 自身的撤销历史回退。

主要功能

  1. 01基于文字稿进行剪辑
  2. 02添加字幕
  3. 03裁剪与重新排列片段
  4. 04添加动效、转场与效果
  5. 05编辑操作可通过应用撤销

适用场景

  1. 01让 Claude 根据文字稿剪掉停顿或错误片段
  2. 02为已打开的视频项目批量添加字幕
  3. 03调整片段顺序并添加转场效果

MCP 相关

该包是 MCP 服务的 stdio 桥接端,客户端通过 npx 启动它,它再将消息转发到 CartCut 内置的 MCP 服务(http://127.0.0.1:9826/mcp)。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"cartesiancs-cartcut": {
"command": "npx",
"args": [
"-y",
"@cartesiancs/cartcut-mcp"
],
"env": {
"CARTCUT_MCP_TOKEN": "<CARTCUT_MCP_TOKEN>"
}
}
}
}
启动命令npx -y @cartesiancs/cartcut-mcp
需要配置的环境变量
CARTCUT_MCP_TOKEN密钥Optional. CartCut's MCP token; read from CartCut's own settings when unset.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@cartesiancs/cartcut-mcp0.1.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

@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_URLhttp://127.0.0.1:9826/mcpCartCut 监听的地址。

如果未设置 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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。