MCP Image Processor

🚀 MCP 图像处理服务器

MCP 图像处理服务器是一款基于 Model Context Protocol (MCP) 开发的高性能图像处理工具。它提供了格式转换、尺寸调整、旋转翻转以及后处理等丰富的图像处理功能，能满足多样化的图像处理需求。

🚀 快速开始

MCP 图像处理服务器是一款高性能的图像处理工具，要使用它，可按以下步骤操作：

1. 克隆仓库：

git clone [仓库地址]
cd MCP-image-server

2. 编译代码：

npm install
npm run build

3. 配置 MCP 服务器：编辑 package.json 文件，配置图像处理参数（如输入和输出路径）。

✨ 主要特性

• 格式转换：支持将图片在 JPEG、PNG、WebP、AVIF 等多种格式间进行转换。
• 尺寸调整：可对图像进行缩放、裁剪和拉伸操作，既可以保持比例，也能强制指定尺寸。
• 旋转与翻转：支持任意角度的旋转，以及水平镜像和垂直镜像操作。
• 后处理效果：能够对图像的亮度、对比度、饱和度进行调整，还可应用模糊和锐化等效果。

📦 安装指南

系统要求

• Node.js（版本 14.0 或以上）
• TypeScript（版本 3.9 或以上）
• sharp 图像处理库（用于加速图像操作）

安装步骤

1. 克隆仓库：

git clone [仓库地址]
cd MCP-image-server

2. 安装依赖并编译代码：

npm install
npm run build

3. 配置服务器：编辑 package.json 文件，配置图像处理参数（如输入和输出路径）。

💻 使用示例

MCP 图像处理服务器提供了以下主要功能接口：

基础用法

1. 格式转换

function convertFormat(imagesPath: string[], outputFormat: string): Promise<string[]>

• 描述：将指定格式的图片文件转换为另一种格式。
• 参数：
  • imagesPath：输入图片路径数组。
  • outputFormat：目标格式（如 'jpeg'、'png'）。

2. 尺寸调整

function resize(imagesPath: string[], width?: number, height?: number, maintainRatio = true): Promise<string[]>

• 描述：缩放图片，支持保持宽高比或指定尺寸。
• 参数：
  • imagesPath：输入图片路径数组。
  • width 和 height：目标宽度和高度（可选）。
  • maintainRatio：是否保持比例，默认为 true。

3. 旋转与翻转

function rotateFlip(imagesPath: string[], rotateAngle?: number, flipHorizontal = false, flipVertical = false): Promise<string[]>

• 描述：对图片进行旋转和翻转操作。
• 参数：
  • imagesPath：输入图片路径数组。
  • rotateAngle：旋转角度（范围为 -360 到 360，可选）。
  • flipHorizontal 和 flipVertical：是否水平或垂直翻转。

4. 后处理效果

function postProcess(imagesPath: string[], brightness = 0, contrast = 0, saturation = 0, blur = 0, sharpen = 0): Promise<string[]>

• 描述：调整图片的亮度、对比度、饱和度，并应用模糊或锐化效果。
• 参数：
  • imagesPath：输入图片路径数组。
  • brightness：亮度调整（范围为 -1 到 1）。
  • contrast：对比度调整（范围为 -1 到 1）。
  • saturation：饱和度调整（范围为 -1 到 1）。
  • blur：模糊半径（单位为像素，可选）。
  • sharpen：锐化强度（范围为 0 到 100）。

📚 详细文档

项目结构

MCP-image-server/
├── src/                # TypeScript 源代码
│   └── index.ts        # 主程序文件
├── dist/               # 编译输出目录
│   └── index.js        # 编译后的主程序
├── package.json        # 项目配置和依赖管理
└── tsconfig.json       # TypeScript 编译配置

📄 许可证

本项目采用 MIT License © 2025。

感谢您使用 MCP 图像处理服务器！欢迎贡献代码并提出宝贵意见！