mcp-image MCP Server

Works with Claude Desktop, Claude Code, Cursor and any Model Context Protocol client. Runs on your own machine, or hosted with no install.

Local serverstdioMIT

What is the mcp-image MCP Server?

mcp-image is an MCP project maintained in the theluckystrike/mcp-image repository. The maintainer describes its purpose as “Works with Claude Desktop, Claude Code, Cursor and any Model Context Protocol client. Runs on your own machine, or hosted with no install”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
image_infoFormat, pixel dimensions, megapixels, aspect ratio, file size in bytes, whether the image carries an alpha channel, and the bytes it spends per pixel
image_resizeA resized copy. inside fits within the box and keeps the ratio, cover fills the box and crops the overflow, exact stretches. Give one of width or height and…
image_convertRe-encode as PNG, JPEG, BMP, GIF or TIFF. Transparency going to JPEG is flattened onto white, and the answer says so
image_compressSmaller bytes, with the count before and after and the percentage saved. quality (default 80), max_width, and max_bytes to hit a size target in one call
image_cropCut a rectangle: x, y from the top-left, width, height. A rectangle past an edge is refused with the real size, never clamped
image_thumbnailsOne thumbnail per file into out_dir, each fitting inside size by size and keeping its aspect ratio
image_watermarkText over the image at a corner and an opacity, white on a translucent plate. With no text, your business name from the shared profile mcp-invoice and mcp-docx
image_strip_metadataA copy with pixels and nothing else: EXIF, GPS, camera, capture time, XMP and colour profiles are not carried across
image_batch_resizeResize a whole list into out_dir, each keeping its own aspect ratio, named - x .
image_dominant_colorsThe colours that cover most of an image, as hex codes with the share of pixels each covers. Free: 3; Pro: up to 16
license_statusShow free or Pro mode
license_activateActivate a Pro key (verified offline)

How to install the mcp-image MCP Server

{
  "mcpServers": {
    "image": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-image/dist/index.js"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.