Imagician - MCP Image Editor

A Model Context Protocol (MCP) server for comprehensive image editing operations including resizing, format conversion, cropping, compression, and more.

Features

Resize: Change image dimensions with various fit options
Format Conversion: Convert between JPEG, PNG, WebP, and AVIF
Crop: Extract specific regions from images
Compress: Reduce file size with quality control
Rotate: Rotate images by any angle
Flip: Mirror images horizontally or vertically
Batch Processing: Generate multiple sizes from a single image
Metadata: Extract image information and properties

Installation

From npm

hljs language-bash

npm install -g @flowy11/imagician

From source

hljs language-bash

git clone https://github.com/flowy11/imagician.git
cd imagician
npm install
npm run build

Usage with Claude Code

Add to your Claude Code configuration (~/.config/claude/config/settings/mcp-servers.json):

hljs language-json

{
  "imagician": {
    "command": "npx",
    "args": ["-y", "@flowy11/imagician"]
  }
}

Usage with Cursor

Add to your Cursor configuration (~/.cursor/mcp_settings.json):

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "npx",
      "args": ["-y", "@flowy11/imagician"]
    }
  }
}

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

Quick setup with npx (recommended):

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "npx",
      "args": ["-y", "@flowy11/imagician"]
    }
  }
}

If installed globally via npm:

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "imagician"
    }
  }
}

If installed from source:

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "node",
      "args": ["/path/to/imagician/dist/index.js"]
    }
  }
}

Available Tools

resize_image

Resize an image to specified dimensions with various fit options.

hljs language-vbnet

Parameters:
- inputPath: Path to input image
- outputPath: Path to save resized image
- width: Target width in pixels (optional)
- height: Target height in pixels (optional)
- fit: How to resize (cover, contain, fill, inside, outside)
- preserveAspectRatio: Maintain aspect ratio (default: true)

convert_format

Convert between image formats with quality control.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save converted image
- format: Target format (jpeg, png, webp, avif)
- quality: Quality for lossy formats (1-100, default: 80)

crop_image

Extract a specific region from an image.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save cropped image
- left: Left offset in pixels
- top: Top offset in pixels
- width: Width of crop area
- height: Height of crop area

compress_image

Reduce image file size with quality settings.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save compressed image
- quality: Compression quality (1-100, default: 80)
- progressive: Use progressive encoding for JPEG (default: true)

rotate_image

Rotate an image by any angle.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save rotated image
- angle: Rotation angle in degrees (positive = clockwise)
- background: Background color for exposed areas (default: #000000)

flip_image

Mirror an image horizontally or vertically.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save flipped image
- direction: Flip direction (horizontal, vertical, both)

get_image_info

Extract metadata and information about an image.

hljs language-vbnet

Parameters:
- inputPath: Path to image file

Returns: format, dimensions, color space, file size, etc.

batch_resize

Generate multiple sizes from one image (perfect for responsive images).

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputDir: Directory to save resized images
- sizes: Array of {width, height?, suffix}
- format: Output format for all sizes (optional)

Example Usage in Claude

hljs language-arduino

"Please resize image.jpg to 800x600 pixels"
"Convert photo.png to WebP format with 90% quality"
"Crop avatar.jpg starting at (100, 100) with 200x200 size"
"Generate thumbnail sizes: 150px, 300px, and 600px wide"

Development

hljs language-bash

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

License

MIT

Imagician - MCP Image Editor

A Model Context Protocol (MCP) server for comprehensive image editing operations including resizing, format conversion, cropping, compression, and more.

Features

Resize: Change image dimensions with various fit options
Format Conversion: Convert between JPEG, PNG, WebP, and AVIF
Crop: Extract specific regions from images
Compress: Reduce file size with quality control
Rotate: Rotate images by any angle
Flip: Mirror images horizontally or vertically
Batch Processing: Generate multiple sizes from a single image
Metadata: Extract image information and properties

Installation

From npm

hljs language-bash

npm install -g @flowy11/imagician

From source

hljs language-bash

git clone https://github.com/flowy11/imagician.git
cd imagician
npm install
npm run build

Usage with Claude Code

Add to your Claude Code configuration (~/.config/claude/config/settings/mcp-servers.json):

hljs language-json

{
  "imagician": {
    "command": "npx",
    "args": ["-y", "@flowy11/imagician"]
  }
}

Usage with Cursor

Add to your Cursor configuration (~/.cursor/mcp_settings.json):

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "npx",
      "args": ["-y", "@flowy11/imagician"]
    }
  }
}

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

Quick setup with npx (recommended):

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "npx",
      "args": ["-y", "@flowy11/imagician"]
    }
  }
}

If installed globally via npm:

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "imagician"
    }
  }
}

If installed from source:

hljs language-json

{
  "mcpServers": {
    "imagician": {
      "command": "node",
      "args": ["/path/to/imagician/dist/index.js"]
    }
  }
}

Available Tools

resize_image

Resize an image to specified dimensions with various fit options.

hljs language-vbnet

Parameters:
- inputPath: Path to input image
- outputPath: Path to save resized image
- width: Target width in pixels (optional)
- height: Target height in pixels (optional)
- fit: How to resize (cover, contain, fill, inside, outside)
- preserveAspectRatio: Maintain aspect ratio (default: true)

convert_format

Convert between image formats with quality control.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save converted image
- format: Target format (jpeg, png, webp, avif)
- quality: Quality for lossy formats (1-100, default: 80)

crop_image

Extract a specific region from an image.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save cropped image
- left: Left offset in pixels
- top: Top offset in pixels
- width: Width of crop area
- height: Height of crop area

compress_image

Reduce image file size with quality settings.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save compressed image
- quality: Compression quality (1-100, default: 80)
- progressive: Use progressive encoding for JPEG (default: true)

rotate_image

Rotate an image by any angle.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save rotated image
- angle: Rotation angle in degrees (positive = clockwise)
- background: Background color for exposed areas (default: #000000)

flip_image

Mirror an image horizontally or vertically.

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputPath: Path to save flipped image
- direction: Flip direction (horizontal, vertical, both)

get_image_info

Extract metadata and information about an image.

hljs language-vbnet

Parameters:
- inputPath: Path to image file

Returns: format, dimensions, color space, file size, etc.

batch_resize

Generate multiple sizes from one image (perfect for responsive images).

hljs language-yaml

Parameters:
- inputPath: Path to input image
- outputDir: Directory to save resized images
- sizes: Array of {width, height?, suffix}
- format: Output format for all sizes (optional)

Example Usage in Claude

hljs language-arduino

"Please resize image.jpg to 800x600 pixels"
"Convert photo.png to WebP format with 90% quality"
"Crop avatar.jpg starting at (100, 100) with 200x200 size"
"Generate thumbnail sizes: 150px, 300px, and 600px wide"

Development

hljs language-bash

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

License

MIT

imagician

Imagician - MCP Image Editor

Features

Installation

From npm

From source

Usage with Claude Code

Usage with Cursor

Usage with Claude Desktop

Quick setup with npx (recommended):

If installed globally via npm:

If installed from source:

Available Tools

resize_image

convert_format

crop_image

compress_image

rotate_image

flip_image

get_image_info

batch_resize

Example Usage in Claude

Development

License

Similar Packages

imagician

Imagician - MCP Image Editor

Features

Installation

From npm

From source

Usage with Claude Code

Usage with Cursor

Usage with Claude Desktop

Quick setup with npx (recommended):

If installed globally via npm:

If installed from source:

Available Tools

resize_image

convert_format

crop_image

compress_image

rotate_image

flip_image

get_image_info

batch_resize

Example Usage in Claude

Development

License

Similar Packages