ImageSorcery
๐ ๐ ๐ง ๐ ๐ช - ComputerVision-based ๐ช sorcery of image recognition and editing tools for AI assistants.
What is ImageSorcery?
ImageSorcery is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ ๐ ๐ง ๐ ๐ช - computervision-based ๐ช sorcery of image recognition and editing tools for ai assistants.
๐ ๐ ๐ง ๐ ๐ช - ComputerVision-based ๐ช sorcery of image recognition and editing tools for AI assistants.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ๐ ๐ ๐ง ๐ ๐ช - ComputerVision-based ๐ช sorcery of image recognit
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx imagesorcery-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use ImageSorcery
ImageSorcery MCP is a local, privacy-first image processing server for AI assistants that leverages OpenCV and computer vision to provide 16 tools including object detection, OCR text extraction, cropping, resizing, rotation, blur, color changes, background removal, shape and text drawing, image overlays, and metadata inspection. All processing runs on your own machineโno images are sent to external APIs. It works on Linux, macOS, and Windows and integrates with Claude Desktop and other MCP clients.
Prerequisites
- Python 3.10 or later installed
- pipx installed (`pip install pipx`)
- System libraries: ffmpeg, libsm6, libxext6, and libgl1-mesa-glx (Linux); on macOS Homebrew handles most dependencies
- Claude Desktop or another MCP-compatible client
Install ImageSorcery MCP via pipx
Use pipx to install the package in an isolated environment and then run the post-install step which downloads the computer vision models.
pipx install imagesorcery-mcp
imagesorcery-mcp --post-installInstall system dependencies (Linux)
On Debian/Ubuntu-based systems install the required system libraries that OpenCV depends on.
sudo apt-get install -y ffmpeg libsm6 libxext6 libgl1-mesa-glxConfigure Claude Desktop
Add the ImageSorcery server to Claude Desktop's configuration file. The `timeout` value is set to 100 seconds to accommodate slower model inference on large images.
{
"mcpServers": {
"imagesorcery-mcp": {
"command": "imagesorcery-mcp",
"transportType": "stdio",
"timeout": 100
}
}
}Optionally restrict file access paths
Set the `IMAGESORCERY_AVAILABLE_PATHS` environment variable to a colon-separated (Linux/macOS) or semicolon-separated (Windows) list of directories ImageSorcery is allowed to read from and write to.
# Add to the env block in your Claude Desktop config:
{
"mcpServers": {
"imagesorcery-mcp": {
"command": "imagesorcery-mcp",
"transportType": "stdio",
"timeout": 100,
"env": {
"IMAGESORCERY_AVAILABLE_PATHS": "/home/user/photos:/home/user/output"
}
}
}
}Restart Claude Desktop and test
Restart Claude Desktop to load the server. Ask Claude to detect objects in a local image file to confirm the 16 tools are available.
ImageSorcery Examples
Client configuration
Full Claude Desktop config for ImageSorcery with path restriction. Adjust IMAGESORCERY_AVAILABLE_PATHS to match your image directories.
{
"mcpServers": {
"imagesorcery-mcp": {
"command": "imagesorcery-mcp",
"transportType": "stdio",
"timeout": 100,
"env": {
"IMAGESORCERY_AVAILABLE_PATHS": "/home/user/photos:/home/user/output"
}
}
}
}Prompts to try
Example prompts for image processing tasks through Claude with ImageSorcery.
- "Detect all objects in /home/user/photos/scene.jpg and draw bounding boxes around them"
- "Extract all text from /home/user/documents/scan.png using OCR"
- "Find the cat in /home/user/photos/garden.jpg, crop the image to center on it, and save to /home/user/output/cat.jpg"
- "Resize /home/user/photos/logo.png to 200x200 pixels"
- "Remove the background from /home/user/photos/portrait.jpg"Troubleshooting ImageSorcery
imagesorcery-mcp command not found after pipx install
Run `pipx ensurepath` to add the pipx bin directory to your PATH, then open a new terminal. Alternatively, find the binary at `~/.local/bin/imagesorcery-mcp` and use the full path in your Claude Desktop config.
Post-install fails or object detection models are missing
Run `imagesorcery-mcp --post-install` again in a terminal where you have internet access. On Linux confirm libgl1-mesa-glx is installed before the post-install step, as OpenCV requires it to load.
Permission denied errors when accessing image files
Set `IMAGESORCERY_AVAILABLE_PATHS` to include the directories where your images reside. Without this variable, access may be restricted to the default working directory. Use absolute paths and separate multiple directories with `:` on macOS/Linux or `;` on Windows.
Frequently Asked Questions about ImageSorcery
What is ImageSorcery?
ImageSorcery is a Model Context Protocol (MCP) server that ๐ ๐ ๐ง ๐ ๐ช - computervision-based ๐ช sorcery of image recognition and editing tools for ai assistants. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install ImageSorcery?
Follow the installation instructions on the ImageSorcery GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with ImageSorcery?
ImageSorcery works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is ImageSorcery free to use?
Yes, ImageSorcery is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
ImageSorcery Alternatives โ Similar Search & Data Extraction Servers
Looking for alternatives to ImageSorcery? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
โ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
โ 52.7k๐ท๏ธ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
โ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - ๅบไบ AI ๅฎๆดไฟ็ๆ็็ PDF ๆๆกฃๅ จๆๅ่ฏญ็ฟป่ฏ๏ผๆฏๆ Google/DeepL/Ollama/OpenAI ็ญๆๅก๏ผๆไพ CLI/GUI/MCP/Docker/Zotero
GPT Researcher
โ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
โ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu โ one CLI, zero API fees.
Xiaohongshu
โ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up ImageSorcery in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use ImageSorcery?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.