@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