MCP Directory

How to add ImageSorcery MCP to Claude Desktop

Local computer-vision image recognition and editing tools for AI assistants — crop, detect, OCR, remove background, all on-device. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 320★ · stdio · no auth

Claude Desktop config for ImageSorcery MCP

pipx install imagesorcery-mcp
{
  "mcpServers": {
    "imagesorcery-mcp": {
      "command": "imagesorcery-mcp",
      "args": []
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the ImageSorcery MCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm ImageSorcery MCP's tools appear under the 🔌 tools menu.

Before you start

  • Python 3.10 or higher
  • pipx (recommended) for installation and virtual-environment management
  • System libraries required by OpenCV: ffmpeg, libsm6, libxext6, libgl1-mesa-glx (typically bundled with OpenCV; may be missing in containers like Docker)
  • An MCP client (Claude.app, Cline, Cursor, or another)
  • Run 'imagesorcery-mcp --post-install' after install to download default YOLO models and the CLIP package

What ImageSorcery MCP can do in Claude Desktop

blur

Blurs specified rectangular or polygonal areas of an image using OpenCV; can invert the provided areas (e.g. to blur the background).

change_color

Changes the color palette of an image (e.g. convert to sepia).

config

View and update ImageSorcery MCP configuration settings (e.g. default detection confidence, telemetry).

crop

Crops an image using OpenCV's NumPy slicing approach between two coordinates.

detect

Detects objects in an image using Ultralytics models; 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.

Security

Runs fully locally — images and data stay on your machine. By default no file paths are restricted; set IMAGESORCERY_AVAILABLE_PATHS to one or more allowed directories to limit tools to specific folders (path-list separator ':' on Linux/macOS, ';' on Windows; commas also accepted). Optional anonymous telemetry is disabled by default and must be explicitly opted into; it never collects image data, file paths, IPs, or other PII.

ImageSorcery MCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the ImageSorcery MCP config there under the "mcpServers" key and restart the client.

Is ImageSorcery MCP safe to use with Claude Desktop?

Runs fully locally — images and data stay on your machine. By default no file paths are restricted; set IMAGESORCERY_AVAILABLE_PATHS to one or more allowed directories to limit tools to specific folders (path-list separator ':' on Linux/macOS, ';' on Windows; commas also accepted). Optional anonymous telemetry is disabled by default and must be explicitly opted into; it never collects image data, file paths, IPs, or other PII.

Are my images sent to any external server?

No. ImageSorcery is designed to run entirely locally; your images and data stay on your machine. Optional anonymous telemetry is disabled by default and never includes image data or file paths.

What does the post-install step do?

Running 'imagesorcery-mcp --post-install' creates a config.toml, creates a models directory with model_descriptions.json, downloads default YOLO models for the detect tool, attempts to install the CLIP Python package from Ultralytics' GitHub (needed for the find tool's text prompts), and downloads the CLIP model file.

Can I restrict which directories the tools can access?

Yes. Set the IMAGESORCERY_AVAILABLE_PATHS environment variable to one or more allowed directories. When set, every tool argument named 'path' or ending with '_path' must resolve inside an allowed directory.

View repo Full ImageSorcery MCP page