xImageMCP

A simple image processing tool for Cursor and other MCP-compatible editors. This tool allows you to resize images and generate various image formats for different platforms.

Quick Start with Cursor

The easiest way to use this tool is with npx in Cursor:

1. Open Cursor settings
2. Navigate to Developer > Edit Config
3. Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ximagemcp": {
      "command": "npx",
      "args": ["-y", "ximagemcp"]
    }
  }
}

4. Restart Cursor

That's it! No need to clone or install anything. The tool will be downloaded and run automatically when needed.

Features

Basic Resize

• Resize images by scale factor (0.1 to 10x)
• Maintains aspect ratio automatically
• Generates output filename with '_resized' suffix if not specified
• Returns original and new dimensions

Resize to Dimensions

• Resize images to specific width and/or height
• Maintains aspect ratio if only one dimension is provided
• Perfect for responsive design and specific layout requirements
• Returns original and new dimensions

Image Information

• Get detailed information about any image
• View dimensions, format, color space, and file metadata
• Useful for debugging and understanding image properties

Retina Images

• Generate @1x, @2x, and @3x versions of an image
• Perfect for iOS/macOS development
• Maintains aspect ratio
• Creates appropriately named files

Mobile App Icons

• Generate all required icon sizes for iOS and Android
• iOS: 20px to 1024px (13 sizes)
• Android: 48px to 512px (6 sizes)
• Square format for app stores
• Platform-specific naming

BlurHash Generation

• Generate blurHash strings from local images or URLs
• Perfect for progressive image loading and placeholders
• Customizable component count for quality vs size tradeoff
• Works with both local files and remote URLs

Example Usage

Basic Resize

Resize this image to 50% of its original size

or

Resize this image with a scale of 2

Resize to Dimensions

Resize this image to width 800px

or

Resize this image to height 600px

or

Resize this image to 800x600 pixels

Get Image Information

Get information about this image

or

What are the dimensions of this image?

Generate Retina Images

Generate retina versions of this image

Generate Mobile Icons

Generate mobile app icons for iOS and Android

or

Generate only iOS app icons

Generate BlurHash

Generate a blurHash for this image

or

Generate a blurHash from this URL: https://example.com/image.jpg

Development

If you're developing the tool:

# Install dependencies
npm install

# Build
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector build/index.js

Requirements

• Node.js 16 or higher
• Sharp image processing library
• MCP-compatible editor (like Cursor)