🚀 MCP 图像处理服务器
MCP 图像处理服务器是一款基于 Model Context Protocol (MCP) 开发的高性能图像处理工具。它提供了格式转换、尺寸调整、旋转翻转以及后处理等丰富的图像处理功能，能满足多样化的图像处理需求。
🚀 快速开始
MCP 图像处理服务器是一款高性能的图像处理工具，要使用它，可按以下步骤操作：
- 克隆仓库：
git clone [仓库地址]
cd MCP-image-server
- 编译代码：
npm install
npm run build
- 配置 MCP 服务器：编辑
package.json文件，配置图像处理参数（如输入和输出路径）。
✨ 主要特性
- 格式转换：支持将图片在 JPEG、PNG、WebP、AVIF 等多种格式间进行转换。
- 尺寸调整：可对图像进行缩放、裁剪和拉伸操作，既可以保持比例，也能强制指定尺寸。
- 旋转与翻转：支持任意角度的旋转，以及水平镜像和垂直镜像操作。
- 后处理效果：能够对图像的亮度、对比度、饱和度进行调整，还可应用模糊和锐化等效果。
📦 安装指南
系统要求
- Node.js（版本 14.0 或以上）
- TypeScript（版本 3.9 或以上）
sharp图像处理库（用于加速图像操作）
安装步骤
- 克隆仓库：
git clone [仓库地址]
cd MCP-image-server
- 安装依赖并编译代码：
npm install
npm run build
- 配置服务器：编辑
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 图像处理服务器！欢迎贡献代码并提出宝贵意见！