MCP Image Processor

🚀 MCP 图像处理服务器

MCP 图像处理服务器是一款高性能的图像处理工具，基于 Model Context Protocol (MCP) 开发。它能提供格式转换、尺寸调整等多种图像处理功能，极大提升了图像处理的效率和便捷性。

🚀 快速开始

MCP 图像处理服务器是一款基于 Model Context Protocol (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

配置 MCP 服务器

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

💻 使用示例

基础用法

以下是使用 MCP 图像处理服务器主要功能的代码示例：

格式转换

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

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

尺寸调整

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

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

旋转与翻转

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

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

后处理效果

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 图像处理服务器！欢迎贡献代码并提出宝贵意见！