OpenClip：视频编辑
edit_video 每次调用对视频文件执行一个操作：裁剪、修剪、旋转、调整大小、压缩或静音。它完全免费，需要一个 OpenClip 账户，但无需订阅或积分。
将多次调用链接起来以组合操作：将一次调用的输出作为下一次调用的输入。
设置（一次性）
OpenClip 是位于 https://openclip.app/mcp 的远程 MCP 服务器。出现 OAuth 提示时使用你的 OpenClip 账户登录，无需复制 API 密钥。
- Claude Code：
claude mcp add --transport http openclip https://openclip.app/mcp，然后运行/mcp进行授权。 - Claude Desktop / web： 进入设置，找到连接器，点击“添加自定义连接器”，粘贴 URL，然后登录。
- Cursor（
.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } } - 仅支持标头的客户端： 在
openclip.app/settings/connect生成 MCP 令牌，然后连接到https://openclip.app/mcp/key，并带上Authorization: Bearer <token>。
验证：调用 get_account。
获取文件
create_upload(filename, content_type)返回一个id和一个upload_url。- 将原始字节 PUT 到
upload_url。 - 将返回的
id作为video参数传入。
不要调用 complete_upload。 该操作会启动付费剪辑流程。免费工具直接读取已上传的文件。list_videos 中已有的视频也可以作为输入。
操作
每次调用都是 edit_video(video, operation, ...params)。
- crop - 可以是
aspect（"1:1"、"9:16"、"16:9"、"4:5"）或明确的x、y、width、height。使用aspect: "9:16"将横屏视频重新调整为 TikTok、Reels 和 Shorts 的竖屏格式。 - trim -
start_ms和end_ms，两者均为必填项。时间单位为毫秒。 - rotate -
degrees（90、180、270）和/或flip（none、horizontal、vertical）。 - resize - 以像素为单位的
width和height。 - compress - 可以是
target_mb（目标文件大小）或crf（18 到 32，数值越低质量越好，文件越大）。当用户指定了大小限制时，使用target_mb。 - mute - 无参数，移除音频轨道。
轮询
edit_video 返回一个 tool_job 哈希 ID，其 status 为 "queued"。每 5 到 10 秒轮询一次 get_tool_job_status(tool_job)：
queued/processing- 仍在处理中，继续轮询。completed- 返回永久的 CDNoutputsURL 以及result_meta。failed- 返回error。
永远不要假设调用会同步完成。
规则
- 每次调用仅一个操作。如果需要先修剪再调整比例，请先运行修剪，然后将其输出传递给裁剪调用。
- 所有时间单位均为毫秒，而非秒。
- 输出 URL 是永久的 CDN 链接，不会过期或需要签名。
- 免费使用有每日速率限制和单个文件大小上限。错误信息会说明如何解除限制。
示例提示到操作
- “将此视频裁剪为前 30 秒” -
create_upload，PUT 字节，edit_video(video, operation="trim", start_ms=0, end_ms=30000)，轮询。 - “将此视频调整为竖屏用于 TikTok” -
edit_video(video, operation="crop", aspect="9:16")，轮询。 - “此文件 400MB，请将其压缩到 50MB 以下” -
edit_video(video, operation="compress", target_mb=50)，轮询。 - “移除音频” -
edit_video(video, operation="mute")，轮询。 - “修剪到中间一分钟并将其调整为正方形” - 修剪，轮询，然后以
aspect="1:1"对输出进行裁剪，再次轮询。
相关
格式转换（mp4、gif、mp3）请使用 convert_media，参见 openclip-convert 技能。将长视频转换为排名靠前的短视频剪辑属于付费流程，参见 openclip-clipping。