@shonsukee/image-editor-mcp

A Model Context Protocol (MCP) server for image editing.

Features

| Tool | Description | |------|-------------| | adjust_brightness | Adjust image brightness (e.g., factor 1.5 for 50% brighter, 0.5 for 50% darker) | | crop_image | Crop image to specified rectangle (left, top, width, height) | | compress_image | Compress image with quality setting (1-100, supports JPEG/PNG/WebP) | | optimize_image | Trim whitespace from image edges automatically | | convert_to_pdf | Convert image to PDF document |

All tools support PDF input as image source.

Installation

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "image-editor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shonsukee/image-editor-mcp",
        "/path/to/your/resources"
      ]
    }
  }
}

Restart Claude Desktop to apply changes.

Cursor

Edit .cursor/mcp.json in your project or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "image-editor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shonsukee/image-editor-mcp",
        "/path/to/your/resources"
      ]
    }
  }
}

MCP Inspector (for testing)

npx @modelcontextprotocol/inspector npx @shonsukee/image-editor-mcp

Tool Parameters

adjust_brightness

| Parameter | Type | Description | |-----------|------|-------------| | sourceFilename | string | Path to source image/PDF file | | outputFilename | string | Path to output image file | | factor | number | Brightness multiplier (e.g., 1.5 = 50% brighter) |

crop_image

| Parameter | Type | Description | |-----------|------|-------------| | sourceFilename | string | Path to source image/PDF file | | outputFilename | string | Path to output image file | | left | number | Left position of crop area | | top | number | Top position of crop area | | width | number | Width of crop area | | height | number | Height of crop area |

compress_image

| Parameter | Type | Description | |-----------|------|-------------| | sourceFilename | string | Path to source image/PDF file | | outputFilename | string | Path to output image file | | quality | number | Compression quality (1-100) |

optimize_image

| Parameter | Type | Description | |-----------|------|-------------| | sourceFilename | string | Path to source image/PDF file | | outputFilename | string | Path to output image file |

convert_to_pdf

| Parameter | Type | Description | |-----------|------|-------------| | sourceFilename | string | Path to source image file | | outputFilename | string | Path to output PDF file |

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Run inspector
npm run inspector

License

MIT