Image Process MCP Server

🚀 Image Processing MCP Server

An MCP server for image processing, leveraging the Sharp library to offer image manipulation capabilities.

🚀 Quick Start

MacOS/Linux

{
  "mcpServers": {
    "Image Process MCP": {
      "command": "npx",
      "args": ["-y", "image-process-mcp-server"]
    }
  }
}

Windows

{
  "mcpServers": {
    "Image Process MCP": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "image-process-mcp-server"]
    }
  }
}

✨ Features

This server provides the following image processing tools:

1. Resize Image (resizeImage): Adjust the width and height of an image.
2. Convert Format (convertFormat): Convert an image to different formats (jpeg, png, webp, avif, tiff, gif).
3. Crop Image (cropImage): Crop a specified area of an image.
4. Rotate Image (rotateImage): Rotate an image.
5. Get Image Info (getImageInfo): Retrieve basic information about an image (size, format, etc.).

💻 Usage Examples

Basic Usage

In Claude, you can invoke the tools as follows:

Resize Image

Please resize this image to a width of 500 pixels.
Input Path: /path/to/input.jpg
Output Path: /path/to/output.jpg

Convert Format

Please convert this PNG image to JPG format.
Input Path: /path/to/input.png
Output Path: /path/to/output.jpg

Crop Image

Please crop this image starting from an offset of 100 pixels from the top-left corner and 200 pixels from the bottom-right corner.
Input Path: /path/to/input.jpg
Output Path: /path/to/cropped.jpg

Rotate Image

Please rotate this image 90 degrees clockwise.
Input Path: /path/to/input.jpg
Output Path: /path/to/rotated.jpg

Get Image Info

Please provide detailed information about this image.
Image Path: /path/to/image.png

Advanced Usage

Tool Parameters

Resize Image (resizeImage)

{
  "input_path": "Path to the input image",
  "output_path": "Path to the output image",
  "width": "Width in pixels (optional)",
  "height": "Height in pixels (optional)",
  "fit": "Resizing method, options: cover, contain, fill, inside, outside. Default is cover"
}

Convert Format (convertFormat)

{
  "input_path": "Path to the input image",
  "output_path": "Path to the output image",
  "format": "Target format, options: jpeg, png, webp, avif, tiff, gif",
  "quality": "Image quality (1 - 100), only applicable to formats supporting compression. Default is 80"
}

Crop Image (cropImage)

{
  "input_path": "Path to the input image",
  "output_path": "Path to the output image",
  "left": "Left edge offset in pixels",
  "top": "Top edge offset in pixels",
  "right": "Right edge offset in pixels",
  "bottom": "Bottom edge offset in pixels"
}

Rotate Image (rotateImage)

{
  "input_path": "Path to the input image",
  "output_path": "Path to the output image",
  "degree": "Rotation angle (clockwise, range: -180 to 180 degrees)"
}

Get Image Info (getImageInfo)

{
  "input_path": "Path to the image"
}

🔧 Technical Details

Dependencies

• Node.js
• Sharp
• @modelcontextprotocol/sdk

📄 License

MIT