openclip-video-editing

OpenClip：视频编辑

edit_video 每次调用会对视频文件执行一项操作：裁剪、剪辑、旋转、调整大小、压缩或静音。它是免费的，需要 OpenClip 账户，但无需订阅或额度。

串联调用以组合多项操作：将一次调用的输出传入下一次调用。

设置（仅需一次）

OpenClip 是一个远程 MCP 服务，地址为 https://openclip.app/mcp。出现 OAuth 提示时，使用你的 OpenClip 账户登录，无需复制 API 密钥。

• Claude Code： claude mcp add --transport http openclip https://openclip.app/mcp，然后运行 /mcp 进行授权。
• Claude Desktop / web： 进入 Settings、Connectors，选择 "Add custom connector"，粘贴 URL 并登录。
• Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• 仅支持请求头的客户端： 在 openclip.app/settings/connect 创建 MCP 令牌，然后使用 Authorization: Bearer <token> 连接到 https://openclip.app/mcp/key。

快速检查：调用 get_account。

获取文件

1. create_upload(filename, content_type) 会返回一个 id 和一个 upload_url。
2. 将原始字节 PUT 到 upload_url。
3. 将返回的 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 会返回一个带有 status: "queued" 的 tool_job hashid。每隔 5 到 10 秒轮询一次 get_tool_job_status(tool_job)：

• queued / processing - 仍在处理中，继续轮询。
• completed - 返回永久 CDN outputs URL 和 result_meta。
• failed - 返回 error。

切勿假设调用会同步完成。

规则

• 每次调用只能执行一项操作。若要先剪辑再重新构图，先运行剪辑操作，然后将其输出传入裁剪调用。
• 所有时间单位均为毫秒，而非秒。
• 输出 URL 是永久 CDN 链接，不是签名链接，也不会过期。
• 免费使用每天有速率限制，且每个文件有大小上限。错误文本会说明如何提高限制。

示例提示词对应的操作

• "Cut this down to the first 30 seconds" - create_upload，PUT 字节， edit_video(video, operation="trim", start_ms=0, end_ms=30000)，然后轮询。
• "Make this vertical for TikTok" - edit_video(video, operation="crop", aspect="9:16")，然后轮询。
• "This file is 400MB, get it under 50" - edit_video(video, operation="compress", target_mb=50)，然后轮询。
• "Strip the audio" - edit_video(video, operation="mute")，然后轮询。
• "Trim to the middle minute and make it square" - 剪辑、轮询，然后将输出传入裁剪操作并设置 aspect="1:1"，再轮询一次。

相关

格式转换（mp4、gif、mp3）使用 convert_media，参见 openclip-convert 技能。将长视频转换为按排名排列的短片段属于付费流水线，参见 openclip-clipping。