# @clipwright/mcp-server 中文文档

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

版本：0\.47\.0
npm 元数据更新时间：2026-11-09T12:30:04.573Z
中文译文更新时间：2026-11-10T02:00:39.502Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40clipwright/mcp-server
原文对照：https://npmcn.com/package/%40clipwright/mcp-server/?lang=original
项目主页：https://clipwright.io/?ref=npm
源码仓库：https://github.com/seocombat/clipwright-mcp

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

- 包体积（解压后）：267 kB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2026-07-26T18:39:10.576Z
- 最新版本发布：2026-11-09T12:30:04.352Z
- 近 30 天下载量：5400（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

Clipwright 的 MCP 服务器: 从您的编码代理生成 UGC 视频

## 安装

```sh
npm install @clipwright/mcp-server
```

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

## README

# @clipwright/mcp-服务器

您的编码代理撰写脚本; [剪贴笔](https://clipwright.io/?ref=npm) 调制 一个演员说这话的短长的垂直视频,默认为1080×1920. 还有 从剧本或短篇小说中 制作长度为30至90秒的无脸相片: 透过一个开场的动画片段和图像场景,没有摄像头放映机. 经纪人 要求免费引用 之前它花费什么, 和无论API不能 荣誉归来 `warnings[]` 而不是被无声地扔下.

经纪人得到一个 `run_id` 立刻投票,直到视频URL准备好. Clipwright 返回文件; 它不会在任何地方发布 。 引用,声音, 行为者和账户余额是免费的。 贷方支出:开立的账户 签了420个成绩 足够90秒的无脸视频 买更多 [io/定价](https://clipwright.io/pricing?ref=npm)。 。 。 .

## 安装

连接有两种方式: 主机服务器在 `https://mcp.clipwright.io/mcp`,或者这个软件包在本地运行 在stdio。 两者 提供同样的工具.

### 主机服务器, 无密钥

添加 URL 到您的客户端 。 首先使用客户端打开浏览器,您签名 进入Clipwright并批准应用程序. **Claude 代码和设备代码流 以下经核实为2026-10-18年现场直播;** 其他命令来自每个命令 客户端自己的文档, 尚未与 Clipwright 进行尝试 .

-   **克劳德代码** (核实现场): `claude mcp add --transport http clipwright https://mcp.clipwright.io/mcp`, (中文(简体) ), 然后运行 `/mcp` 在会话中签名.
-   **克劳德.艾和克劳德桌面:** 自定义 / 连接器 / 添加自定义 连接器,然后粘贴 URL .
-   **聊天游戏**,在网络上:chitchgpt.com/plugins +按钮 + 添加自定义 MCP 服务器, 粘贴 URL, 选择 OAuth, 然后创建为插件并安装 这个 在聊天中, 类型 `@` 并选取.
-   **光标 :** 内 `~/.cursor/mcp.json`, (中文(简体) ), `{"mcpServers": {"clipwright": {"url": "https://mcp.clipwright.io/mcp"}}}`。 。 。 .
-   **VS 代码 :** 内 `.mcp.json` 在工作空间根, `{"mcpServers": {"clipwright": {"type": "http", "url": "https://mcp.clipwright.io/mcp"}}}`。 。 。 .
-   **双子座CLI:** `gemini mcp add --transport http clipwright https://mcp.clipwright.io/mcp`, (中文(简体) ), 接下来 `/mcp auth clipwright`。 。 。 .
-   **代码 :** `codex mcp add clipwright --url https://mcp.clipwright.io/mcp`, (中文(简体) ), 接下来 `codex mcp login clipwright`。 。 。 .

批准页面列出应用程序要求的权限. 有两个:

-   `mcp:read` ——标出只读的工具:帐号,运行,镜头,声音, 演员、工作流程和引用.
-   `mcp:write` ——其他工具. 一些开始付费运行 **支出信贷**· ; 其余更改账户(演员、上传、工作流程计划).

没有连接 `mcp:write` 获得 `403 insufficient_scope` 从那些 工具,没有收费。 只有经认可的账户才能批准.

要断开一个应用程序, 打开 [app.clipwright.io/ api-键](https://app.clipwright.io/api-keys), (中文(简体) ), 把它藏起来 **已连接的应用程序** 并废除它。 它的下一个请求得到 `401`A级 连接从批准起持续90天;之后应用程序要求您签名 再来一次.

在主机服务器上 `upload_image` 无法读取您机器上的文件 。 通过 a 公开 https URL 为 `upload_image({url})` 或调用 `create_upload` 并 PUT 文件返回返回 `put_url` 和卷发。 无论是 让你得到一个 `upload_id` 页:1 `first_frame`, (中文(简体) ), `last_frame` 财务报告和审定财务报表 `references`。 。 。 .

**没有浏览器的代理** 使用设备代码和第一当事方签名 客户端 `clipwright-agent` (核查直播2026-10-18):

```bash
curl -s https://mcp.clipwright.io/device/auth -d client_id=clipwright-agent \
  --data-urlencode "scope=mcp:read mcp:write offline_access" \
  --data-urlencode "resource=https://mcp.clipwright.io/mcp"
```

打开 `verification_uri` (单位:千美元)`https://mcp.clipwright.io/device`在任何设备, 输入 `user_code`,签名和批准;批准页重复代码. 同时投票 `POST https://mcp.clipwright.io/token` 与 `grant_type=urn:ietf:params:oauth:grant-type:device_code`,则 `device_code` 财务报告和审定财务报表 `client_id=clipwright-agent`,频率不超过每5秒:更快 民意调查 `slow_down`发送 `access_token` 作为 `Authorization: Bearer` 改为 `/mcp`它持续一个小时。 续以: `grant_type=refresh_token` 并保留 每次刷新最新鲜的标志 设备流只对这个客户端开放 .

### 以 a 为主机服务器 `cw_*` 键

对于CI和脚本,发送一个密钥而不是签名进来. 钥匙两个都拿着 权限.

```bash
claude mcp add --transport http clipwright https://mcp.clipwright.io/mcp --header "Authorization: Bearer cw_..."
```

### 无 8n

n8n的内置 **MCP 客户端** 节点每个节点调用一个工具 :

-   **服务器传输 :** HTTP可流; **MCP 端点 URL :** `https://mcp.clipwright.io/mcp`。 。 。 .
-   **认证 :** 比尔·奥特,有一份证书... .. `cw_...` 键.
-   **工具 :** 从列表中选择, 例如 `quote_ugc`· ; **输入模式 :** 贾森.

2026-10-20上线验证,自办n8n 2.43.8: `get_account`, (中文(简体) ), `quote_ugc` 财务报告和审定财务报表 `get_run` 通过节点返回。 要导入的工作流程, `n8n/clipwright-ugc.json` 内 [seocombat/clipwright-mcp (英语)](https://github.com/seocombat/clipwright-mcp), (中文(简体) ), 引用脚本, 当上面引用时停止 `max_credits`开始 `make_ugc` 和民意调查 `get_run` 每15秒钟。 整个工作流程运行在N8n Cloud上 2026-10-20,并在约3分钟后返回了一架1080×1920 MP4. n8n 的 OAuth 数据 证书还没有对Clippwright运行.

### 本地服务器通过 stdio

```bash
claude mcp add clipwright -e CLIPWRIGHT_API_KEY=cw_... -- npx -y -p @clipwright/mcp-server clipwright-mcp
```

把钥匙换掉 `cw_...`。命令是一行并给出 贝壳没什么可扩张的,所以击打,zsh和PowerShell运行它一样。 这需要 节点.js20或更新.

任何MCP主机的作品——本地服务器会说出JSON-RPC过stdio. 发出密钥时 [app.clipwright.io/ api-键](https://app.clipwright.io/api-keys)。 。 。 .

## 环境

这些变量配置本地服务器 .

| 变量 | 需求 | 含义 |
| --- | --- | --- |
| `CLIPWRIGHT_API_KEY` | 对 |  `cw_*` 符号 。 过程没有它立即退出. |
| `CLIPWRIGHT_CLIENT_ID` | 建议 | 确定这一点 **安装** 并进入一能键, 因此两个装置 永远不会崩溃为一跑。 左起未设置, 服务器保留一个 `~/.clipwright/client-id`适合一台笔记本电脑 设定为共享、复制或只读的家目录—— 容器、 CI、 复制图像—— 如 `SKILL.md` §2解释. |
| `CLIPWRIGHT_API_URL` | 没有 | 默认为主机 API . |

## 食谱

每份食谱都是我们给一个代理的提示 连接了这个服务器 代理发送, 和视频的成本。 视频播放在 [(原始内容存档于2017-09-21). shitchwright.io/mcp](https://clipwright.io/mcp#examples)。 。 。 .

### 1\. 有屏幕图形的创建相册

一名摄影师,她身上的图形 反应了她所说的话: 销售出产品 的说话头片的形式。 一个快速,没有编辑.

以我们的演员身份、截图链接和网站命名 与之相伴的是:

> 帮我的AI接待员 做个30秒的垂直胶卷 与我的演员和声音希望。 作文:"每失所召是失所约. 你的接待员睡觉 休息 有时会很生气 这个不行 它接通了一整天的电话 24小时不停地工作 从来不生气 这里有一个真实的:一个顾客早上2点打电话来订清扫,它处理一切,时间,价格,确认文本. 小企业错过了三分之一的电话。 现在不是了。 10分钟后就安排好 睡觉时不要失去交易"
> 
> 她在列出内容的同时, 显示一张带有三个开关的核对表(“回答呼叫”和“工作24/7”关闭, 当她到达凌晨2点的顾客,在"手"上显示从+1(305)555-0147的接通电话,并在"手"上接通. 把我的仪表盘截图放在右上角 她却说 "小生意错过了三分之一的电话" 在我的网站卡片上结束 "创造你的助手" 说明只取出关键线条,以突出显示器风格,再以"不再有"来放大一点. 译出前引出.

经纪人寄的: 一 `make_ugc` 引用为 `templates` (名单、电话、, 结束( c), 1 `overlays` 图片, `caption_mode: "highlights"`, (中文(简体) ), `caption_style: "highlighter"` (单位:千美元) `punch_in` 在一条线上。 单击, 开关和铃声默认带有模板。 我们查过了 在2026-10-24年的这台服务器上有一个新鲜的代理设备;视频从该机上传出 同一个电话.

任何物品用完前的引号为价格; 列出名称 费率. [小心点](https://clipwright.io/mcp#examples)。 。 。 .

## 工具

-   `list_workflows` 读取工作流程方法和当前可用性。 免费.
-   `get_workflow` ——读出一种方法所要求的输入,脚本规则,证据和限制. 免费.
-   `prepare_workflow_plan` ——用完整的文档创建,或用两者同时保存 `plan_id` 财务报告和审定财务报表 `base_version`。免费;开始不运行.
-   `plan_reference_remake` ——服务器汇编了参考广告的分析(`analysis_id`,或者描述本身),以及你准确的脚本写入了一个新的计划;它的警告名称是计划没有复制的. 自由; 开始不运行并生成任何结果 .
-   `get_workflow_plan` ——解读当前自主规划,修订和准备. 免费.
-   `approve_workflow_plan` ——明确批准选取的修订和内容摘要. 自由; 开始不运行 .
-   `quote_workflow_plan` ——引出核定订正后,不花出贷项.
-   `run_workflow_plan` 使用精确的引号字段和明确的一能键启动付费工作流程。 立即归还收据和身份证;民意调查 `get_run`。用原始请求和密钥回收不确定的购买.
-   `list_voices` - 声音支持 `voice`:预设,30个声音 语音模型 `gemini-3.8-flash-tts` 和目录 `make_ugc`,与 按语言、性别、年龄、使用大小写和模型以及短音频进行过滤 样本中的声音有一个。 十七个描述的声音 `make_faceless` 以 `skill: "make_faceless"`免费,不花 学分.
-   `list_template_sounds` 声音 `make_ugc` 模板播放, 通过节拍: 在哪里 每个节奏,它的默认和每个名字 `template_sounds` 拿着 免费.
-   `list_moves` - 动作、动作和图形目录 脚本为 `moves` 联 合 国 `make_ugc`, (中文(简体) ), `make_faceless` 财务报告和审定财务报表 `plan_reference_remake`数字 : 各为观者所行所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取. 免费.
-   `list_actors` ——现成面相并有稳定标识和可验证格式. 免费.
-   `quote_ugc` 估计持续时间和价格,加警告 `make_ugc` 同样的投入将因金钱或出入而被拒绝。 免费.
-   `get_account` ——账户的余额,债务和持有. 免费.
-   `list_prices` 每个工具的信用成本:单位数,或 公式,价格取决于输入;免费工具列表为 0. 免费.
-   `send_feedback` 告诉克利普赖特什么是缺失的,混淆的,错误的或慢的, 可选择的运行;我们每读一次。 免费.
-   `describe_tool` 充分指导一种工具或其一个领域 工具列表简略给出。 免费.
-   `make_ugc` —— 说 **制作短片,这是需要钱的电话.** 回返a `run_id` 而不是阻挡, 因为一个渲染需要几分钟.
-   `get_run` 跑步状态 免费;每隔几秒钟就去投票一次.
-   `get_run_shots` 完成的视频的镜头:跨度、类型、描述 并预览每个词的链接,其中包含描述词及其时间。 免费和 只读。 一次没有镜头的跑步 却能用原因证明答案.
-   `delete_run_media` ——删除已完成运行的文件:它们停止打开于 一次,7天后从存储处被去除;运行及其充电停留. 拒绝,而另一个未完成的运行使用它们。 免费.
-   `quote_revision` ——无相视频修订价格:会是什么 变化及其代价。 免费.
-   `revise_run` —— 说 **开始修改: 重新让视频生效的新运行 这需要钱.** 过 `changes` (射击和什么) 或整个编辑器 `document`. 提供 (b) 一个失败者不收取任何费用。 同样的 请求返回相同的运行; `attempt` 故意启动第二个。 回返a `run_id` 立即; 民意调查 `get_run` 直至 `succeeded`。 。 。 .
-   `quote_candidate` ——无面相相相相片候选人出价:一幅相片 或为一发子弹而制作的剪辑,以保留或丢弃修改。 免费.
-   `create_candidate` —— 说 **这需要钱.** 通过 和为它生成的操作。 对一名送来的候选人收费 其一个单位,无论是保留还是丢弃; 失败的单位被充电 没什么 相同的请求 返回相同的运行; `take` 另有人选 回返a `run_id` 立即; 民意调查 `get_run` 直至 `succeeded`。 。 。 .
-   `list_generation_models` - 单代模式及其 每个图像或每秒测量出形状和入分。 免费.
-   `quote_image`, (中文(简体) ), `quote_video` ——一张相片或一张相片的价格. 免费.
-   `generate_image`, (中文(简体) ), `generate_video` —— 说 **制作一个图像或一个静音片段; 这需要钱.** 一个失败的不收费。 相同的请求返回相同的运行; `attempt` 开始 又一个是故意的。 票价 `get_run`· ; `generation.url` 这是文件.
-   `upload_image` - 来自当地的一个巴布亚新几内亚/巴布亚新几内亚政府 `path` 或公众 https `url` → `upload_id` 和一个签名的 https url 以 `image`。免费;每天20天 大多数每小时30个url下载,url活了24小时. 设定 `aspect_ratio` 明确之后.
-   `create_upload` ——当服务器是 PNG/JPEG 时,本地 PUT 预先签名的 PUT 远程:将文件卷起,然后使用 `upload_id`免费的.
-   `get_upload` - 上传一个新鲜的url,它的大小和 `usable_until`· ; 之后 `create_upload` 它证实了PUT。 免费.
-   `delete_upload` ——删除上传:从此以后没有任何工具拿走,及其上传 7天后从存储中删除文件。 未完成运行使用时被拒绝 这个 免费.
-   `create_asset` ——将图片或 MP4 剪辑保存为账户资产,保存 直到您删除它: 从 a `run_id`,一个 `upload_id`,公众 `url` (一个短片) 与 `kind: "video"`, (中文(简体) ), `base64`,预先签名 `put`,以及当地 `path` 打开 斯特迪奥。 在背景中检查剪辑 : `get_asset` 说,当它是 准备 你自己的物质需要 `rights_confirmed: true` 一次 一次吗 免费; 2000 资产和每个账户1GB(购买信贷后20GB),100个新的 每天买的.
-   `list_assets`, (中文(简体) ), `get_asset` ——账户资产有新鲜的urls和 盖用之. 免费.
-   `update_asset` 重新命名资产或改变其作用。 免费.
-   `delete_asset` ——删除资产;每天清理一次其文件7天 已经过去了。 免费.
-   `quote_analysis` 资产参考分析的价格:70个贷项,或0个 当资产的分析会回答。 免费.
-   `analyze_reference` 将参考广告(MP4资产,最多120 s)读入 `reference_profile`: beats,我们模板词汇中的图形,标题, 节奏和我们无法画的东西。 一次返回;民意调查 `get_reference_analysis`70 信用一旦成功,即予以持有和收取;a 分析失败毫无代价。 每小时10个新的分析.
-   `get_reference_analysis` 分析状况及其细分和 警告一旦成功 `next`数字 : `plan_reference_remake` 联合国 `analysis_id`对于一个视频像参考。 简介和框架 链接 `include: ["profile", "frames"]`免费的.
-   `quote_creator_profile` 链接的创建者简介价格:20分, 或0,当同一创造者 从最后一个小时的描述会回答。 免费.
-   `analyze_creator` —— 描述Instagram 或 TikTok 配置背后的创建者 或视频链接:他们最新的12个视频,有观点,喜欢,评论和分享, 中位值和每个视频的x, 顶级的表演者和cadence。 等着 ;未完成的读取为 `get_creator_profile`. 20 (简体中文) 账户费用; 私人或空账户费用 没什么 每小时30个新简介.
-   `get_creator_profile` - 创作者简介及其录像和 一旦成功就发出警告。 免费.
-   `delete_creator_profile` ——同时删除一个已完成的创建者配置文件;运行 这使得它和它的收费 停留。 免费.
-   `quote_trends` - 趋势搜索的价格:20个入分,或者在搜索时为0 最后一个小时的同样的询问会回答 免费.
-   `find_trends` 在主题上脱落的相片: TikTok 和 默认排序中的Instagram(`platform: mix`),或者在其中一个上,上 每个平台张贴10卷 `posted_within_days`每个创造者一人, 以 reel 相对于其创建者的中位值的视图排序 . `language` 只过滤 TikTok 卷轴。 等待结果; 未完成的读取 通过重复呼叫,免费。 20个积分,一旦成功, 当组合只到达一个平台时(`warnings[]` 名称; a 搜索中找不到任何胶卷 不需要花费什么。 每小时10个新搜索.
-   `quote_actor` ——个人演员在创作前的价格. 免费.
-   `create_actor` —— 说 **从描述中创建个人演员; 费用 钱.** 所请求的每一种格式都是单独的充电图像. 与 `portrait` (你自己的9: 16图像资产) 这个图像成为演员的肖像在否 ,并且只收取其他格式的费用。 回返a `run_id` 立即; 民意调查 `get_run` 直至 `succeeded`,然后通过 `created_actor.actor_id` 改为 `make_ugc` 作为 `actor_id`。 。 。 .
-   `quote_faceless` ——拍摄一部无脸相片前的价格. 免费.
-   `make_faceless` —— 说 **制作您剧本或短片中的无脸视频 简言之,这需要钱.** 你选了30到90秒,视频以它结束 说明,至少25秒(一个解释者,只要其说明),通常在选择之后最多四分之一秒 和90(较长的叙述到其结束),最多要花费引文。 叙述在开场白上播放 动画剪辑和图像场景,默认情况下带有字幕. `voice` 选择 说出名字来 回返a `run_id` 立即; 民意调查 `get_run` 直至 `succeeded`。 。 。 .
-   `delete_actor` ——删除此账户的个人角色. 已经录制的视频 保持原样 免费.
-   `get_actor_defaults`, (中文(简体) ), `set_actor_defaults` - 读并保存一个演员的 B 卷 默认。 仅存:今天的谈话演员视频不使用. 免费.
-   `extract_brand` - 将公共网站的颜色、字体、标志和角读入 a 拟议数 `design` 并附有可读文本,供您确认。 免费.
-   `brand_kit` 没有 `design`,阅读账户的保存设计和外观 和取出的脸 `design`,保存它,所以系列保持一看. 一个叫不的视频 `design` 或者说 `template_theme` 画在包里。 免费.

打电话 `quote_ugc` 在此之前 `make_ugc`引文是合同告诉你的 它会和不会荣誉。 API无法交付的都回来 `warnings[]` 而不是被悄悄地丢弃, 和无支持的领域 而不是被接受和忽视.

弹出 `attempt` 字段开始 a **新的已支付费用**这是重试的方式 故意运行失败, 不是免费刷新 。 对于无脸视频 `attempt` 属于 `make_faceless`:引文不需要,而且 `quote_faceless` 拒绝.

`SKILL.md` 装满操作指令的船. [shitchwright.io/changelog (英语)](https://clipwright.io/changelog) 就说每件事都变了 释放和什么被删除.

## 隐私

服务器将您的脚本或简短的、选定的选项和任何上传的图像发送给 Clipwright API来引用和渲染视频. 如何处理这些数据: [(原始内容存档于2018-09-26). shitchwright.io/privacy](https://clipwright.io/privacy)文档: [io/文件](https://clipwright.io/docs?ref=npm)。 。 。 .

## 常见问题

### @clipwright/mcp-server 是什么？

Clipwright 的 MCP 服务器: 从您的编码代理生成 UGC 视频

### 如何安装 @clipwright/mcp-server？

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

### @clipwright/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @clipwright/mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

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

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

### @clipwright/mcp-server 可以商用吗？

@clipwright/mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @clipwright/mcp-server 的下载量有多少？

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

### @clipwright/mcp-server 还在维护吗？

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