MCP Image Processor

🚀 MCP Image Processing Server

MCP Image Processing Server is a high - performance image processing tool developed based on the Model Context Protocol (MCP). This server offers a variety of image processing functions, including format conversion, resizing, rotation and flipping, and post - processing operations.

🚀 Quick Start

The MCP Image Processing Server is a high - performance tool for various image processing tasks. Here's a quick guide to get you started.

✨ Features

• Format Conversion: Supports converting images from one format to another (e.g., JPEG, PNG, WebP, AVIF, etc.).
• Resizing: Allows image scaling, cropping, and stretching, either maintaining the aspect ratio or forcing a specified size.
• Rotation and Flipping: Supports rotation at any angle, as well as horizontal and vertical mirroring operations.
• Post - processing Effects: Includes adjustments for brightness, contrast, and saturation, along with blurring and sharpening effects.

📦 Installation

System Requirements

• Node.js (version 14.0 or higher)
• TypeScript (version 3.9 or higher)
• sharp image processing library (for accelerating image operations)

Installation Steps

Clone the Repository

git clone [Repository URL]
cd MCP-image-server

Compile the Code

npm install
npm run build

Configure the MCP Server

Edit the package.json file to configure image processing parameters (e.g., input and output paths).

💻 Usage Examples

The MCP Image Processing Server provides the following main functional interfaces:

Basic Usage

1. Format Conversion

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

• Description: Converts image files in a specified format to another format.
• Parameters:
  • imagesPath: An array of input image paths.
  • outputFormat: The target format (e.g., 'jpeg', 'png').

2. Resizing

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

• Description: Resizes images, supporting maintaining the aspect ratio or specifying dimensions.
• Parameters:
  • imagesPath: An array of input image paths.
  • width and height: The target width and height (optional).
  • maintainRatio: Whether to maintain the aspect ratio, default is true.

3. Rotation and Flipping

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

• Description: Performs rotation and flipping operations on images.
• Parameters:
  • imagesPath: An array of input image paths.
  • rotateAngle: The rotation angle (ranging from -360 to 360, optional).
  • flipHorizontal and flipVertical: Whether to flip horizontally or vertically.

4. Post - processing Effects

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

• Description: Adjusts the brightness, contrast, and saturation of images, and applies blurring or sharpening effects.
• Parameters:
  • imagesPath: An array of input image paths.
  • brightness: Brightness adjustment (ranging from -1 to 1).
  • contrast: Contrast adjustment (ranging from -1 to 1).
  • saturation: Saturation adjustment (ranging from -1 to 1).
  • blur: Blur radius (in pixels, optional).
  • sharpen: Sharpening intensity (ranging from 0 to 100).

📚 Documentation

Project Structure

MCP-image-server/
├── src/                # TypeScript source code
│   └── index.ts        # Main program file
├── dist/               # Compiled output directory
│   └── index.js        # Compiled main program
├── package.json        # Project configuration and dependency management
└── tsconfig.json       # TypeScript compilation configuration

📄 License

MIT License © 2025

Thank you for using the MCP Image Processing Server! Contributions and valuable feedback are welcome!