Image-Refinery 是一款基于 Rust 构建的高性能模型上下文协议 (MCP) 服务器，专注于图像处理、格式转换及元数据重构。它能够为 AI 助手和开发工具提供精密的图像操作能力，支持从基础的尺寸调整到复杂的智能裁剪、背景移除及 EXIF 元数据编辑等全方位功能。

核心特性

• 几何变换 (Geometric Transformations)：支持图像缩放、裁剪、旋转及翻转。
• 智能裁剪 (Smart Crop)：具备内容感知能力，自动识别并保留视觉焦点区域。
• 视觉滤镜 (Visual Filters)：内置模糊、锐化、灰度化、亮度/对比度调节及圆角处理等功能。
• 格式转码 (Format Transcoding)：在 PNG、JPG、WebP 和 AVIF 等主流格式间进行高质量转换。
• 资源优化 (Asset Optimization)：通过智能的有损或无损压缩算法，在保持质量的同时大幅减少文件体积。
• 图层合成 (Layer Compositing)：支持图像或文本叠加，具备精确的定位控制与混合模式。
• 背景移除 (Background Removal)：一键生成透明的 PNG/WebP 图像，适用于 Logo、图标及产品图。
• 图标生成 (Icon Generation)：自动创建多尺寸应用图标集及多层级 .ico 文件。
• 元数据清除 (Metadata Removal)：通过像素级重新编码，彻底清除 EXIF、GPS 等敏感信息。
• 元数据编辑 (Metadata Editing)：支持对图像设置自定义 EXIF 标签（如版权、作者、描述等）。
• 格式检测 (Robust Format Detection)：自动识别并处理文件扩展名不匹配的情况（例如以 .png 结尾的 JPEG 文件）。

支持的运行环境

本服务器兼容所有支持 MCP 协议的工具，包括但不限于：

• IDE/编辑器：Antigravity, Windsurf, Cursor, Zed
• 插件/扩展：Roo Code, Cline, Augment Code
• 客户端：Claude Desktop

工具参考指南

1. analyze_image

提取图像文件的技术元数据。

• 主要功能：检测尺寸（宽/高）、文件格式、色彩空间及 EXIF 数据（如果存在）。
• 输入参数：image_path（支持 glob 通配符模式，如 *.jpg）。
• 输出结果：包含图像详细规格和 EXIF 信息的 JSON 对象。

2. transform_image

执行基础的几何变换。

• 主要功能：缩放、裁剪、旋转及翻转。
• 选项说明：支持 smart_crop（内容感知）和手动 crop 区域。
• 参数列表：image_path (输入), width, height, rotate, flip, flop, quality (1-100)。

3. resize_image

专门用于图像缩放的轻量级工具。

• 主要功能：调整图像尺寸。若仅提供单一维度，则会自动保持纵横比。
• 参数列表：image_path (输入), width, height, quality (1-100)。

4. stylize_image

应用各类视觉滤镜与视觉调整。

• 主要功能：模糊、锐化、灰度转换、亮度/对比度调整以及圆角化处理。
• 参数列表：image_path (输入), blur, sharpen, grayscale, brightness, contrast, rounded_corners, quality。

5. convert_format

在不同文件格式间进行转码。

• 主要功能：在 PNG, JPG, WebP, 和 AVIF 之间进行转换。
• 参数列表：image_path (输入), format (目标格式), quality (1-100)。
• 注意：转换后的新文件将不包含原始元数据。

6. optimize_image

通过压缩算法减小文件体积。

• 主要功能：在不改变图像尺寸的前提下，最小化存储空间占用。
• 参数列表：image_path (输入), quality (1-100) 或 lossless (布尔值)。

7. composite_image

将图像或文本叠加到基础图像上。

• 主要功能：添加水印、Logo 或说明文字，支持精确坐标定位。
• 参数说明：image_path (底图), overlays 数组 (包含 path/text, x, y, font_size, color)。

8. remove_background

生成透明背景图像。

• 主要功能：移除背景以提取主体，输出支持透明通道的 PNG 或 WebP。
• 参数列表：image_path (输入), force_color (16进制颜色), sensitivity (low/medium/high), format ("png" | "webp")。

9. generate_icons

为应用开发生成全套图标。

• 主要功能：生成一系列不同尺寸的 PNG 图标，并可选生成多层级 .ico 文件。
• 参数列表：image_path (输入), sizes (数组), generate_ico (布尔值)。

10. set_metadata

通过向文件写入指定标签来设置图像元数据 (EXIF)。

• 运行模式：仅覆盖模式。现有元数据将被替换，而非合并。
• 支持的标签：Copyright, Artist, Software, Description, UserComment, Make, Model。
• 支持的格式：JPG, PNG, WebP。
• 参数列表：image_path, tags (键值对对象)。

配置指南

请将以下配置项添加到您的 MCP 配置文件中：

{
  "mcpServers": {
    "image-refinery": {
      "command": "npx",
      "args": ["-y", "@datafrog-io/image-refinery"],
      "env": {
        "IMAGE_REFINERY_API_KEY": "YOUR_LICENSE_KEY"
      }
    }
  }
}