MCP Directory

How to add ImageSorcery MCP to Windsurf

Local computer-vision image recognition and editing tools for AI assistants — crop, detect, OCR, remove background, all on-device. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf config for ImageSorcery MCP

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

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the ImageSorcery MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5ImageSorcery MCP's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the ImageSorcery MCP config there under the "mcpServers" key and restart the client.

Is ImageSorcery MCP safe to use with Windsurf?

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