mcpField
O
openclip-thumbnails

openclip-thumbnails

github.com/openclip-app创意与媒体144 次安装12 周前更新
代码仓库

关于 openclip-thumbnails

openclip-thumbnails 是用于从视频提取画面并编辑图片的技能，适合制作缩略图或调整图片文件。它提供免费的帧提取、压缩、缩放、裁剪和格式转换工具。

主要功能

  1. 01从视频提取多个画面
  2. 02按宽度输出画面
  3. 03压缩图片
  4. 04调整图片尺寸
  5. 05按比例或坐标裁剪图片
  6. 06转换图片格式

适用场景

  1. 01从视频生成候选缩略图
  2. 02提取多个画面供挑选
  3. 03将图片裁剪为方形 WebP
  4. 04压缩大型 PNG 文件

MCP 相关

该技能使用 OpenClip 远程 MCP 服务执行视频帧提取、图片编辑和异步任务状态查询。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclip-app/agent-skills --skill openclip-thumbnails

安装后在 Claude Code 中输入/openclip-thumbnails确认已加载。

详细介绍

OpenClip：缩略图和图像编辑

两个免费工具，通常搭配使用：

  • extract_thumbnails - 从视频中提取帧。
  • edit_image - 压缩、调整大小、裁剪或转换图像格式。

这两个工具都免费，需要 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 / 网页版： 打开设置，选择连接器（“Connectors”），点击“添加自定义连接器”（“Add custom connector”），粘贴 URL 并登录。
  • Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
  • 仅支持 Header 的客户端： 在 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（缩略图）或 file（图像编辑）参数传入。

请勿调用 complete_upload。 这会启动付费剪辑流程。免费工具会直接读取上传的文件。list_videos 中已有的视频也可以作为输入。

extract_thumbnails

extract_thumbnails(video, count?, width?)。

  • count - 1 到 10，默认值为 1。帧会分布在整个视频中，因此 count: 5 会生成一张大致的联系表，供你挑选。
  • width - 输出帧的可选像素宽度。

输出是帧的 zip 文件，而不是单独的图像 URL。将 zip 文件 URL 提供给用户，或者在需要特定帧时解压。

如果用户想要的是某个确切时刻的帧，而不是均匀分布的帧，先使用 edit_video（operation="trim"，参见 openclip-video-editing）将视频裁剪到该时刻，然后从裁剪后的视频中提取一张缩略图。

edit_image

edit_image(file, operation, ...params)，每次调用执行一个操作：

  • compress - quality 为 1 到 100（默认值为 80），可选的 format（jpg、png、webp）。
  • resize - width 和 height 的单位为像素，可选的 format。
  • crop - 使用 aspect（"1:1"、"9:16"、"16:9"、"4:5"）或指定 x、y、width、height，可选的 format。

图像要用于网页时使用 webp，需要确保兼容性时使用 jpg。

轮询

这两个工具都会返回一个带有 status: "queued" 的 tool_job hashid。每隔 5 到 10 秒调用一次 get_tool_job_status(tool_job) 进行轮询：

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

规则

  • 始终进行轮询，这两个工具都是异步的。
  • 每次调用 edit_image 只执行一个操作。要先调整大小再压缩，请依次调用两次。
  • extract_thumbnails 始终返回 zip 文件。不要向用户承诺会提供单独的帧 URL。
  • 输出 URL 是永久 CDN 链接，不会签名或过期。
  • 免费用量有每日速率限制，且每个文件的大小也有限制。

示例提示词与操作

  • “从这个视频中提取一张缩略图” - create_upload，PUT 字节数据， extract_thumbnails(video)，轮询，然后返回 zip 文件 URL。
  • “给我 5 帧供选择” - extract_thumbnails(video, count=5)，然后轮询。
  • “我要 1:30 时的帧” - edit_video(video, operation="trim", start_ms=90000, end_ms=91000)， 轮询，然后对该输出调用 extract_thumbnails，再轮询。
  • “把这张图裁成正方形 webp” - edit_image(file, operation="crop", aspect="1:1", format="webp")，然后轮询。
  • “这个 PNG 太大了，帮我压缩一下” - edit_image(file, operation="compress", quality=75, format="webp")，然后轮询。

相关内容

将主体抠出并保存为透明 PNG，请参见 openclip-remove-background。视频裁剪和剪切，请参见 openclip-video-editing。

评论

支持 Markdown