image-process-mcp-server

🚀 图片处理 MCP 服务器

这是一个用于图像处理的 MCP 服务器，借助 Sharp 库为用户提供丰富的图像操作功能，能满足多样化的图片处理需求。

🚀 快速开始

MacOS/Linux 系统

{
  "mcpServers": {
    "Image Process MCP": {
      "command": "npx",
      "args": ["-y", "image-process-mcp-server"]
    }
  }
}

Windows 系统

{
  "mcpServers": {
    "Image Process MCP": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "image-process-mcp-server"]
    }
  }
}

✨ 主要特性

该服务器提供了以下强大的图像处理工具：

1. 调整图片尺寸 (resizeImage)：可灵活调节图片的宽度和高度。
2. 转换图片格式 (convertFormat)：能将图片转换为多种不同的格式，如 jpeg、png、webp、avif、tiff、gif。
3. 裁剪图片 (cropImage)：精准裁剪图片的指定区域。
4. 旋转图片 (rotateImage)：实现图片的旋转操作。
5. 获取图片信息 (getImageInfo)：快速获取图片的基本信息，如尺寸、格式等。

📦 安装指南

此服务器的运行依赖以下组件：

• Node.js
• Sharp
• @modelcontextprotocol/sdk

请确保在使用前已正确安装这些依赖项。

💻 使用示例

基础用法

在 Claude 中，您可以使用以下方式调用工具：

调整图片尺寸

请帮我将这张图片调整为宽度 500 像素。
输入路径：/path/to/input.jpg
输出路径：/path/to/output.jpg

转换图片格式

请把这张 PNG 格式的图片转换成 JPG 格式。
输入路径：/path/to/input.png
输出路径：/path/to/output.jpg

裁剪图片

请将这张图片从左上角偏移 100 像素、右下角偏移 200 像素的位置裁剪出来。
输入路径：/path/to/input.jpg
输出路径：/path/to/cropped.jpg

旋转图片

请将这张图片顺时针旋转 90 度。
输入路径：/path/to/input.jpg
输出路径：/path/to/rotated.jpg

获取图片信息

请告诉我这张图片的详细信息。
图片路径：/path/to/image.png

工具参数说明

调整图片尺寸 (resizeImage)

{
  "input_path": "输入图片的路径",
  "output_path": "输出图片的路径",
  "width": 宽度（像素，可选）,
  "height": 高度（像素，可选）,
  "fit": "调整方式，选项：cover, contain, fill, inside, outside，默认为 cover"
}

转换图片格式 (convertFormat)

{
  "input_path": "输入图片的路径",
  "output_path": "输出图片的路径",
  "format": "目标格式，可选值：jpeg, png, webp, avif, tiff, gif",
  "quality": 图片质量（1 - 100），仅适用于支持压缩的格式，默认为 80
}

裁剪图片 (cropImage)

{
  "input_path": "输入图片的路径",
  "output_path": "输出图片的路径",
  "left": 左边缘偏移量（像素）,
  "top": 上边缘偏移量（像素）,
  "right": 右边缘偏移量（像素）,
  "bottom": 下边缘偏移量（像素）
}

旋转图片 (rotateImage)

{
  "input_path": "输入图片的路径",
  "output_path": "输出图片的路径",
  "degree": 旋转角度（顺时针方向，范围： - 180 到 180 度）
}

获取图片信息 (getImageInfo)

{
  "input_path": "图片的路径"
}

📄 许可证

本项目采用 MIT 许可证。