MCP 图像处理服务器

项目简介

MCP 图像处理服务器是一款高性能的图像处理工具，基于 Model Context Protocol (MCP) 开发。该服务器提供多种图像处理功能，包括格式转换、尺寸调整、旋转翻转、后处理等操作。

功能概览

• 格式转换：支持将图片从一种格式转换到另一种格式（如 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 图像处理服务器提供以下主要功能接口：

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