Imagesorcery MCP Server

Official website: [imagesorcery.net](https://imagesorcery.net?utm_source=readme)

Local serverstdioPython

What is the Imagesorcery MCP MCP server?

If you want an AI assistant working directly with Imagesorcery MCP, the imagesorcery mcp mcp server is the bridge. Official website: imagesorcery.net.

What Imagesorcery MCP does

Official website: imagesorcery.net

Tools it exposes

Once connected, the assistant can call these 14 tools directly:

  • blur — Blurs specified rectangular or polygonal areas of an image using OpenCV. Can also invert the provided areas e.g. to blur background
  • change_color — Changes the color palette of an image
  • config — View and update ImageSorcery MCP configuration settings
  • crop — Crops an image using OpenCV's NumPy slicing approach
  • detect — Detects objects in an image using models from Ultralytics. Can return segmentation masks (as PNG files) or polygons
  • draw_arrows — Draws arrows on an image using OpenCV
  • draw_circles — Draws circles on an image using OpenCV
  • draw_lines — Draws lines on an image using OpenCV
  • draw_rectangles — Draws rectangles on an image using OpenCV
  • draw_texts — Draws text on an image using OpenCV
  • fill — Fills specified rectangular, polygonal, or mask-based areas of an image with a color and opacity, or makes them transparent. Can also invert the provided areas
  • find — Finds objects in an image based on a text description. Can return segmentation masks (as PNG files) or polygons
  • get_metainfo — Gets metadata information about an image file
  • ocr — Performs Optical Character Recognition (OCR) on an image using EasyOCR

Installing the imagesorcery mcp mcp server

The server is distributed via PyPI as imagesorcery-mcp, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Requirements

  • Python 3.10 or higher - pipx (recommended) - for easy installation and virtual environment management - ffmpeg, libsm6, libxext6, libgl1-mesa-glx - system libraries required by OpenCV - Claude.app, Cline, or another MCP client Virtual environments (e.g. Docker) These dependencies are typically included with OpenCV installation and don't require

Where it fits

Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Imagesorcery MCP sits in that group, and the shape of its toolset — blur, change_color, config among others — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • With 14 tools exposed, expect a noticeable bump in prompt size — disable it in projects that never use Imagesorcery MCP.
  • Maintained by sunriseapps, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the imagesorcery mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
blurBlurs specified rectangular or polygonal areas of an image using OpenCV. Can also invert the provided areas e.g. to blur background.
change_colorChanges the color palette of an image
configView and update ImageSorcery MCP configuration settings
cropCrops an image using OpenCV's NumPy slicing approach
detectDetects objects in an image using models from Ultralytics. Can return segmentation masks (as PNG files) or polygons.
draw_arrowsDraws arrows on an image using OpenCV
draw_circlesDraws circles on an image using OpenCV
draw_linesDraws lines on an image using OpenCV
draw_rectanglesDraws rectangles on an image using OpenCV
draw_textsDraws text on an image using OpenCV
fillFills specified rectangular, polygonal, or mask-based areas of an image with a color and opacity, or makes them transparent. Can also invert the provided areas e.g. to remove background.
findFinds objects in an image based on a text description. Can return segmentation masks (as PNG files) or polygons.
get_metainfoGets metadata information about an image file
ocrPerforms Optical Character Recognition (OCR) on an image using EasyOCR

How to install the Imagesorcery MCP MCP server

**For manual venv installation:**
```json
"mcpServers": {
    "imagesorcery-mcp": {
      "command": "/full/path/to/venv/bin/imagesorcery-mcp",
      "transportType": "stdio",
      "autoApprove": ["blur", "change_color", "config", "crop", "detect", "draw_arrows", "draw_circles", "draw_lines", "draw_rectangles", "draw_texts", "fill", "find", "get_metainfo", "ocr", "overlay", "resize", "rotate"],
      "timeout": 100
    }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.10 or higher - pipx (recommended) - for easy installation and virtual environment management - ffmpeg, libsm6, libxext6, libgl1-mesa-glx - system libraries required by OpenCV - Claude.app, Cline, or another MCP client Virtual environments (e.g. Docker) These dependencies are typically included with OpenCV installation and don't require

Example prompts to try

  • Use Imagesorcery MCP to blur.
  • Use Imagesorcery MCP to change color.
  • Use Imagesorcery MCP to config.

Frequently asked questions

It connects Imagesorcery MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (blur, change_color, config, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Imagesorcery MCP directly.