MCP 图像处理服务器
English README
基于 Model Context Protocol (MCP) 的高性能图像处理服务器,提供格式转换、尺寸调整、压缩优化等丰富的图像处理功能。
功能概览
- 支持多种图像格式转换:JPEG、PNG、WebP、TIFF、GIF、AVIF、HEIF
- 灵活的图像裁剪与尺寸调整
- 图像质量压缩与元数据移除优化
- 多种缩放模式,支持保持或调整宽高比
- 旋转角度及水平/垂直翻转
- 亮度、对比度、饱和度调整及模糊、锐化后处理
系统要求
- Node.js 18 及以上版本
- TypeScript 5 及以上版本
- 支持
sharp原生模块的运行环境
安装与快速开始
1. 克隆仓库```bash
git clone https://github.com/HYPERVAPOR/mcp-image-processor.git
cd mcp-image-processor
### 2. 安装依赖```bash
npm install
3. (可选)修改代码
如果需要自定义 MCP Server 逻辑,请编辑 src/index.ts,修改完成后执行:```bash
npm run build
### 4. 配置 MCP Server
以 `cline` 客户端为例,其他客户端(如 `cursor`, `cherryStudio`)配置类似:```json
{
"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 描述你想对图片执行的操作,并提供一个或多个图片的绝对路径,例如:```text
请你将此图片转换为黑白色调,图片位于 "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 图像处理服务器,欢迎贡献与反馈!
