ChangeImageTo

MCP Server Python 3.10+ License: MIT ChangeImageTo Powered by FastAPI backend

A production-ready Model Context Protocol (MCP) server for AI-assisted image editing. Give Cursor, Claude Desktop, Windsurf, VS Code MCP, and other MCP hosts 16 tools to remove backgrounds, blur or grayscale backgrounds, change colors, convert formats (PNG/JPEG/WebP/…), upscale, denoise/enhance, run OCR, export PDF, edit text in images (Gemini), clean watermarks, inpaint masked regions, and run bulk resize / convert / quality checks.

Search-friendly aliases: image editing MCP · MCP image tools · background removal MCP · remove background API MCP · photo editing LLM tools · Cursor image MCP · Claude image MCP · batch image processing MCP · image upscaling MCP · OCR MCP server.

The server is a small HTTP client: it forwards requests to the same ChangeImageTo image API used by changeimageto.com. Point it at the hosted backend (default) or at your own deployment of the matching /api/* routes.

---

Why this repo?

You want…	This MCP provides…
Remove background / transparent PNG	remove_background
Portrait / product cutouts	category: product or portrait
Blur background (bokeh-style)	blur_background
Grayscale background only	grayscale_background
Color grading (hue / saturation / brightness / contrast)	change_image_color
Convert image format	convert_image_format
Upscale 2× / 3× / 4×	upscale_image
Sharpen / denoise / deblur	enhance_image
Strip text from photos	remove_text_from_image
Remove Gemini watermark	remove_gemini_watermark
Replace text in an image (AI)	edit_text_in_image
Image → PDF	image_to_pdf
Image → text (OCR)	image_to_text_ocr
Inpaint with a user mask	remove_painted_areas
Bulk resize / convert / quality	bulk_* tools

---

GitHub topics (repository tags)

GitHub allows 20 topics per repository. This repo’s topics (for search and discoverability):

mcp · model-context-protocol · mcp-server · image-editing · image-processing · background-removal · remove-background · photo-editing · image-tools · cursor · claude · claude-desktop · llm · ai-tools · python · ocr · image-upscaling · inpainting · fastapi · changeimageto

---

Install

git clone https://github.com/vipul510-web/mcp-changeimageto.git
cd mcp-changeimageto
python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install .

Install from Git without cloning:

pip install git+https://github.com/vipul510-web/mcp-changeimageto.git

---

Cursor, Claude Desktop, VS Code — MCP config

Replace paths with yours:

{
  "mcpServers": {
    "changeimageto": {
      "command": "/full/path/to/mcp-changeimageto/.venv/bin/python",
      "args": ["/full/path/to/mcp-changeimageto/server.py"],
      "env": {
        "CHANGEIMAGETO_API_BASE": "https://bgremover-backend-121350814881.us-central1.run.app"
      }
    }
  }
}

Or use the console script after pip install .:

{
  "mcpServers": {
    "changeimageto": {
      "command": "/full/path/to/.venv/bin/mcp-changeimageto"
    }
  }
}

The entrypoint runs mcp.run() (stdio transport).

---

Environment variables

Variable	Default	Meaning
CHANGEIMAGETO_API_BASE	https://bgremover-backend-121350814881.us-central1.run.app	API origin (no trailing slash). Matches the backend used by changeimageto.com (the marketing site does not serve /api/* itself).
CHANGEIMAGETO_HTTP_TIMEOUT	180	HTTP timeout in seconds.
CHANGEIMAGETO_API_TOKEN	—	Optional Authorization: Bearer header if your self-hosted API requires it.

---

Image inputs

Each tool accepts image (or a list for bulk tools) as:

• HTTPS URL to an image
• Local file path
• Data URL: data:image/png;base64,...

Responses that are binary (PNG, JPEG, PDF, ZIP) are returned as JSON with data_base64 when the payload is under ~12 MB. Larger outputs omit base64 and include a short notice—use a local API, smaller files, or non-bulk endpoints.

---

Tools ↔ REST API

MCP tool	HTTP
remove_background	POST /api/remove-bg
blur_background	POST /api/blur-background
grayscale_background	POST /api/grayscale-background
change_image_color	POST /api/change-color
convert_image_format	POST /api/convert-format
upscale_image	POST /api/upscale-image
enhance_image	POST /api/enhance-image
remove_text_from_image	POST /api/remove-text
remove_gemini_watermark	POST /api/remove-gemini-watermark
edit_text_in_image	POST /api/edit-text-in-image
image_to_pdf	POST /api/image-to-pdf
image_to_text_ocr	POST /api/image-to-text
remove_painted_areas	POST /api/remove-painted-areas
bulk_resize_images	POST /api/bulk-resize
bulk_convert_images	POST /api/bulk-convert-format
bulk_quality_check	POST /api/bulk-quality-check

Test-only, blog, analytics, and payment endpoints are not wrapped (by design).

---

Related

• Product & docs: changeimageto.com
• MCP spec: modelcontextprotocol.io
• Issues & ideas: github.com/vipul510-web/mcp-changeimageto/issues

---

License

MIT