MCP 图像处理服务器

English README

基于 Model Context Protocol (MCP) 的高性能图像处理服务器，提供格式转换、尺寸调整、压缩优化等丰富的图像处理功能。

---

功能概览

- 支持多种图像格式转换：JPEG、PNG、WebP、TIFF、GIF、AVIF、HEIF
- 灵活的图像裁剪与尺寸调整
- 图像质量压缩与元数据移除优化
- 多种缩放模式，支持保持或调整宽高比
- 旋转角度及水平/垂直翻转
- 亮度、对比度、饱和度调整及模糊、锐化后处理

---

系统要求

- Node.js 18 及以上版本
- TypeScript 5 及以上版本
- 支持 sharp 原生模块的运行环境

---

安装与快速开始

1. 克隆仓库

git clone https://github.com/HYPERVAPOR/mcp-image-processor.git
cd mcp-image-processor

2. 安装依赖

npm install

3. （可选）修改代码

如果需要自定义 MCP Server 逻辑，请编辑 src/index.ts，修改完成后执行：

npm run build

4. 配置 MCP Server

以 cline 客户端为例，其他客户端（如 cursor, cherryStudio）配置类似：

{
  "mcpServers": {
    "image-processor": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\projs\\mcp-image-processor\\dist\\index.js"],
      "transportType": "stdio"
    }
  }
}

> 注意：请将 command 和 args 替换为你本地的真实路径。

5. 启动使用

确保 MCP Server 已启用：

只需向 LLM 描述你想对图片执行的操作，并提供一个或多个图片的绝对路径，例如：

请你将此图片转换为黑白色调，图片位于 "C:\projs\MCP-image-server\assets\test\climbing.png"

效果演示：

---

可用工具接口说明

1. image.convertFormat — 格式转换

- 参数：

- imagesPath: 绝对路径数组
- outputFormat: 目标格式（jpeg、png、webp、tiff、gif、avif、heif）
- formatParams（可选）:
- quality: 输出质量（0-100）
- compressionLevel: 压缩级别（0-9，9 为最高）

- 功能：将图片转换为指定格式，支持质量与压缩级别调整。

---

2. image.cropResize — 裁剪与尺寸调整

- 参数：

- imagesPath: 绝对路径数组
- width: 目标宽度（像素，可选）
- height: 目标高度（像素，可选）
- resizeMode: 调整模式（contain、cover、fill、inside、outside）
- maintainRatio: 是否保持宽高比（默认 true）
- rotate: 旋转角度（-360 到 360 度，可选）
- flip: 是否垂直翻转（可选）
- mirror: 是否水平翻转（可选）

- 功能：裁剪、缩放、旋转和翻转图片，支持多种尺寸调整策略。

---

3. image.compressOptimize — 压缩与优化

- 参数：

- imagesPath: 绝对路径数组
- quality: 输出质量（0-100，可选）
- stripMetadata: 是否移除 EXIF 等元数据（默认 true）
- progressive: 是否启用渐进式渲染（JPEG/PNG，可选）

- 功能：压缩图片，去除元数据，支持渐进式渲染。

---

4. image.resize — 图像缩放

- 参数：

- imagesPath: 绝对路径数组
- width: 目标宽度（像素，可选）
- height: 目标高度（像素，可选）
- maintainRatio: 是否保持宽高比（默认 true）
- fitMode: 缩放模式（contain、cover、fill、inside、outside，可选）

- 功能：缩放图片，支持保持比例或指定缩放模式。若开启保持比例且目标宽高比与原图不符，将返回错误。

---

5. image.rotateFlip — 旋转与翻转

- 参数：

- imagesPath: 绝对路径数组
- rotateAngle: 旋转角度（-360 到 360 度，可选）
- flipHorizontal: 是否水平翻转（镜像效果，可选）
- flipVertical: 是否垂直翻转（可选）

- 功能：旋转及水平/垂直翻转图片。

---

6. image.postProcess — 图像后处理

- 参数：

- imagesPath: 绝对路径数组
- brightness: 亮度调整（-1 到 1，可选）
- contrast: 对比度调整（-1 到 1，可选）
- saturation: 饱和度调整（-1 到 1，可选）
- blur: 模糊半径（像素，可选）
- sharpen: 锐化强度（0-100，可选）

- 功能：调整亮度、对比度、饱和度，支持模糊与锐化处理。

---

项目结构

MCP-image-server/
├── src/                # TypeScript 源代码
│   └── index.ts        # 主入口文件
├── dist/               # 编译输出目录
│   └── index.js        # 编译后的主入口文件
├── test/               # 测试脚本目录
├── package.json        # 项目配置及依赖
└── tsconfig.json       # TypeScript 编译配置

---

许可证

MIT © 2025

---

感谢您使用 MCP 图像处理服务器，欢迎贡献与反馈！