# @capcut/jianying-mcp 中文文档

规范地址：https://npmcn.com/package/%40capcut/jianying-mcp/

版本：0\.8\.65
npm 元数据更新时间：2026-11-04T02:42:04.523Z
中文译文更新时间：2026-11-09T05:06:03.082Z
软件包许可：SEE LICENSE IN LICENSE

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capcut/jianying-mcp
原文对照：https://npmcn.com/package/%40capcut/jianying-mcp/?lang=original
项目主页：https://www.jianying.com/

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.3 MB，33 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.17\.0
- 运行依赖：0 个
- 首次发布：2026-11-03T12:18:10.715Z
- 最新版本发布：2026-11-04T02:42:04.333Z
- 近 30 天下载量：9942（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

使用本机剪映创作、剪辑、预览和导出视频

## 安装

```sh
npm install @capcut/jianying-mcp
```

也可以使用：`pnpm add @capcut/jianying-mcp`、`yarn add @capcut/jianying-mcp`、`bun add @capcut/jianying-mcp`

## README

# 剪映：npm STDIO 接入

本机运行剪映连接器，检索和打开草稿，执行剪辑、预览与导出。剪映账号登录、权益及系统授权沿用客户端实际流程。

## 配置

正式包发布后，在豆包选择 STDIO，启动命令为 `npx`，参数逐行填写：

```text
--yes
--package=@capcut/jianying-mcp@<固定版本>
--registry=https://registry.npmjs.org/
jianying-mcp
```

版本来自该次正式发行记录；版本占位符和本地测试包名不能直接用于上架。显式使用官方 npm 源，避免宿主默认镜像尚未同步新版本而下载失败。连接器入口从自身安装目录定位运行文件，不依赖工作目录或用户填写机器路径。

npm 包使用宿主运行时；手动 ZIP 不携带运行时，由安装脚本检查并在必要时下载 Node 到用户私有目录。

## 运行环境

由宿主提供 Node.js 18.17+ 和 npm/npx。一个 npm 包支持 Mac Apple Silicon、Intel 和 Windows x64，包内不包含 Bun、Node.js 二进制或平台运行时子包。入口使用 npx 所用的 Node.js 绝对路径启动 STDIO 服务，共享后端和浏览器网关也复用该运行时。系统或 Node.js 版本不支持时返回明确错误。

无需 postinstall、可选运行时依赖，不修改系统 PATH，不注册开机服务。STDIO 原样继承，退出与停止信号转交 Node.js 服务；草稿、登录态和日志沿用现有本机目录，不写入 npm 包。

共享后端按实际运行时构建更新，不只比较 npm 版本号或传输协议。新版 STDIO 将自身运行时入口和 buildId 交给已认证的后端；后端核对清单及文件完整性后保存快照，等待已受理操作收尾并交接状态。支持本地 ZIP 与 npm 缓存等不同目录之间的更新。接管完成前不向旧构建派发新请求；拒绝更新或部署不完整时明确返回错误，不静默使用旧下载配置。已接管的快照与被替代构建记录在状态目录 `shared-runtime-release.json`，旧目录里的 STDIO 重连后跟随新构建，不反向降级。此能力需后端包含跨目录更新实现；更早版本拒绝时需先重启到新版，不强制终止其他宿主的进程。

## 打包与验证

```text
python3 Tools/doubao-hub-pilot/package-npm.py --name <正式包名> --output <新输出目录>
```

脚本从当前源码构建单个 npm tgz，记录源码提交、工作区状态和逐文件哈希。运行代码和卡片依赖已内联，包含第三方许可记录，不包含剪映客户端、测试代码、内部审批材料、node\_modules 或原生扩展。脚本仅打包，不执行发布。

验证换目录、中文及空格路径、最低 Node.js 版本、STDIO 握手、工具发现、卡片资源、WebSocket 转发及重连、stdin 关闭和停止信号。Windows 参数和路径模拟不能代替 Windows 实机验收。

## 发布

使用已经批准的 npm 组织和包名，按固定版本发布单个包。完成从公网 registry 安装和真实宿主回归后填写表单。公开发布须完成公司审批并得到用户明确授权；测试快照若含 dirty=true，应在正式发布前冻结源码并重新打包。

## 常见问题

### @capcut/jianying-mcp 是什么？

使用本机剪映创作、剪辑、预览和导出视频

### 如何安装 @capcut/jianying-mcp？

在项目目录运行 npm install @capcut/jianying-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 jianying-mcp，可以用 npx jianying-mcp 直接运行。

### @capcut/jianying-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/capcut\_\_jianying-mcp 是否存在。

### @capcut/jianying-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.17\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @capcut/jianying-mcp 可以商用吗？

@capcut/jianying-mcp 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @capcut/jianying-mcp 的下载量有多少？

根据 npm 官方下载统计，@capcut/jianying-mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 9,942 次，日均约 331 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @capcut/jianying-mcp 还在维护吗？

最新版本 0\.8\.65 发布于 2026/11/04（5 天前）；至今共发布 3 个版本，其中过去 12 个月发布了 3 个；首次发布于 2026/11/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。