mcpField
I
image-crop

image-crop

github.com/agntswrm创意与媒体6161 次安装34 周前更新
代码仓库

关于 image-crop

image-crop 是通过命令行裁剪图片的 Agent 技能，可从文件路径或 URL 输入图片。它按指定尺寸围绕可配置焦点定位裁剪区域，并提供本地处理方式。

主要功能

  1. 01按指定宽高裁剪图片
  2. 02配置裁剪焦点位置
  3. 03支持文件路径或 URL 输入
  4. 04设置输出路径和 DPI

适用场景

  1. 01突出图片中的指定主体
  2. 02为指定尺寸生成图片裁剪
  3. 03从远程图片 URL 裁剪并保存

安装

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

$npx skills add https://github.com/agntswrm/agent-media --skill image-crop

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

详细介绍

图像裁剪

将图像裁剪为指定尺寸，并以可配置的焦点为中心。裁剪区域会以焦点为中心计算，同时保持在图像边界内。

命令

npx agent-media@latest image crop --in <path> --width <px> --height <px> [options]

输入

选项必填说明
--in是输入文件路径或 URL
--width是裁剪区域的宽度（像素）
--height是裁剪区域的高度（像素）
--focus-x否焦点的 X 坐标，范围为 0-100（默认值：50，即中心）
--focus-y否焦点的 Y 坐标，范围为 0-100（默认值：50，即中心）
--dpi否输出的 DPI/密度（默认值：300）
--out否输出路径、文件名或目录（默认值：./）
--provider否要使用的提供方（默认值：local）

输出

返回包含裁剪后图像路径的 JSON 对象：

{
  "ok": true,
  "media_type": "image",
  "action": "crop",
  "provider": "local",
  "output_path": "cropped_123_abc.png",
  "mime": "image/png",
  "bytes": 45678
}

示例

裁剪为 800x600，并以中心为焦点（默认焦点）：

npx agent-media@latest image crop --in photo.jpg --width 800 --height 600

将焦点设在左上区域（距左侧 20%，距顶部 30%）进行裁剪：

npx agent-media@latest image crop --in photo.jpg --width 800 --height 600 --focus-x 20 --focus-y 30

从 URL 裁剪并使用自定义输出路径：

npx agent-media@latest image crop --in https://example.com/image.jpg --width 1024 --height 768 --out ./output

提供方

  • local（默认）- 使用 Sharp 库，无需 API 密钥

评论

支持 Markdown