MCP 图像处理服务器

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 图像处理服务器，欢迎贡献与反馈！