Changeimageto Free Image Editing Tools

ChangeImageTo MCP — 面向 Cursor、Claude 和任何 MCP 客户端的图像编辑

一个可用于生产环境的 Model Context Protocol（MCP）服务，为 AI 辅助图像编辑提供支持。 为 Cursor、Claude Desktop、Windsurf、VS Code MCP 和其他 MCP 宿主提供 16 种工具，用于移除背景、模糊或灰度化背景、更改颜色、转换格式（PNG/JPEG/WebP/…）、放大、降噪/增强、执行 OCR、导出 PDF、编辑图像中的文字（Gemini）、清除水印、对蒙版区域进行修复，以及批量调整大小/转换/质量检查。

便于搜索的别名： 图像编辑 MCP · MCP 图像工具 · 背景移除 MCP · 移除背景 API MCP · 照片编辑 LLM 工具 · Cursor 图像 MCP · Claude 图像 MCP · 批量图像处理 MCP · 图像放大 MCP · OCR MCP 服务。

此服务是一个轻量级 HTTP 客户端：它将请求转发到 changeimageto.com 使用的同一套 ChangeImageTo 图像 API。你可以将其指向托管后端（默认设置），也可以指向你自行部署的匹配 /api/* 路由。

---

为什么选择此仓库？

你需要……	此 MCP 提供……
移除背景 / 透明 PNG	remove_background
人像 / 商品抠图	category：product 或 portrait
模糊背景（散景效果）	blur_background
仅将背景灰度化	grayscale_background
色彩分级（色相 / 饱和度 / 亮度 / 对比度）	change_image_color
转换图像格式	convert_image_format
放大 2× / 3× / 4×	upscale_image
锐化 / 降噪 / 去模糊	enhance_image
去除照片中的文字	remove_text_from_image
移除 Gemini 水印	remove_gemini_watermark
替换图像中的文字（AI）	edit_text_in_image
图像 → PDF	image_to_pdf
图像 → 文本（OCR）	image_to_text_ocr
使用用户蒙版进行修复	remove_painted_areas
批量调整大小 / 转换 / 质量处理	bulk_* 工具

---

GitHub topics（仓库标签）

GitHub 允许每个仓库设置 20 个 topic。此仓库的 topics（用于搜索和提高可发现性）：

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

---

安装

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 .

从 Git 安装，无需克隆：

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

---

Cursor、Claude Desktop、VS Code — MCP 配置

将路径替换为你自己的路径：

{
  "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"
      }
    }
  }
}

或者在执行 pip install . 后使用控制台脚本：

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

入口点会运行 mcp.run()（stdio 传输）。

---

环境变量

变量	默认值	含义
CHANGEIMAGETO_API_BASE	https://bgremover-backend-121350814881.us-central1.run.app	API 源站（末尾不带斜杠）。与 changeimageto.com 使用的后端一致（营销网站本身不提供 /api/*）。
CHANGEIMAGETO_HTTP_TIMEOUT	180	HTTP 超时时间，单位为秒。
CHANGEIMAGETO_API_TOKEN	—	如果可自托管的 API 需要，可选的 Authorization: Bearer 标头。

---

图像输入

每个工具接受以下形式的 image（批量工具也可接受列表）：

• 图像的 HTTPS URL
• 本地文件路径
• Data URL：data:image/png;base64,...

二进制响应（PNG、JPEG、PDF、ZIP）会以 JSON 返回；当载荷小于约 12 MB 时，其中包含 data_base64。更大的输出不会包含 base64，并会附带简短提示——请使用本地 API、更小的文件或非批量端点。

---

工具 ↔ REST API

MCP 工具	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

仅用于测试的端点、博客、分析和支付端点均不会封装（这是有意为之）。

---

相关链接

• 产品与文档： changeimageto.com
• MCP 规范： modelcontextprotocol.io
• 问题与想法： github.com/vipul510-web/mcp-changeimageto/issues

---

许可证

MIT