Changeimageto - Free Image Editing tools

16 ferramentas para remover fundos, desfocar ou tornar fundos em escala de cinza, alterar cores, converter formatos (PNG/JPEG/WebP/…), aumentar resolução, reduzir ruído/melhorar, executar OCR, exportar PDF, editar texto em imagens (Gemini), limpar marcas d'água, pintar regiões mascaradas e realizar redimensionamento em lote / conversão / verificações de qualidade.

GitHub

Documentação

ChangeImageTo MCP — Edição de imagens para Cursor, Claude e qualquer cliente MCP

Um servidor Model Context Protocol (MCP) pronto para produção para edição de imagens assistida por IA. Dê a Cursor, Claude Desktop, Windsurf, VS Code MCP e outros hosts MCP 16 ferramentas para remover fundos, desfocar ou tornar o fundo em escala de cinza, alterar cores, converter formatos (PNG/JPEG/WebP/…), aumentar a resolução, reduzir ruído/melhorar, executar OCR, exportar PDF, editar texto em imagens (Gemini), limpar marcas d'água, inpaint regiões mascaradas e executar em lote redimensionamento / conversão / verificações de qualidade.

Aliases amigáveis para busca: 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.

O servidor é um pequeno cliente HTTP: ele encaminha solicitações para a mesma API de imagens ChangeImageTo usada por changeimageto.com. Aponte-o para o backend hospedado (padrão) ou para sua própria implantação das rotas /api/* correspondentes.

Por que este repositório?

Você quer…	Este MCP fornece…
Remover fundo / PNG transparente	`remove_background`
Recortes de retrato / produto	`category`: `product` ou `portrait`
Desfocar fundo (estilo bokeh)	`blur_background`
Fundo em escala de cinza apenas	`grayscale_background`
Classificação de cor (matiz / saturação / brilho / contraste)	`change_image_color`
Converter formato de imagem	`convert_image_format`
Aumentar resolução 2× / 3× / 4×	`upscale_image`
Nitidez / redução de ruído / desembaçar	`enhance_image`
Remover texto de fotos	`remove_text_from_image`
Remover marca d'água do Gemini	`remove_gemini_watermark`
Substituir texto em uma imagem (IA)	`edit_text_in_image`
Imagem → PDF	`image_to_pdf`
Imagem → texto (OCR)	`image_to_text_ocr`
Inpaint com uma máscara do usuário	`remove_painted_areas`
Em lote redimensionar / converter / qualidade	`bulk_*` ferramentas

Tópicos do GitHub (tags do repositório)

O GitHub permite 20 tópicos por repositório. Os tópicos deste repositório (para busca e descoberta):

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

Instalação

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 .

Instale a partir do Git sem clonar:

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

Cursor, Claude Desktop, VS Code — configuração MCP

Substitua os caminhos pelos seus:

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

Ou use o script de console após pip install .:

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

O ponto de entrada executa mcp.run() (transporte stdio).

Variáveis de ambiente

Variável	Padrão	Significado
`CHANGEIMAGETO_API_BASE`	`https://bgremover-backend-121350814881.us-central1.run.app`	Origem da API (sem barra final). Corresponde ao backend usado por changeimageto.com (o site de marketing não serve `/api/*` em si).
`CHANGEIMAGETO_HTTP_TIMEOUT`	`180`	Tempo limite HTTP em segundos.
`CHANGEIMAGETO_API_TOKEN`	—	Cabeçalho `Authorization: Bearer` opcional se sua API auto-hospedada exigir.

Entradas de imagem

Cada ferramenta aceita image (ou uma lista para ferramentas em lote) como:

URL HTTPS para uma imagem
Caminho de arquivo local
Data URL: data:image/png;base64,...

Respostas binárias (PNG, JPEG, PDF, ZIP) são retornadas como JSON com data_base64 quando o payload tem menos de ~12 MB. Saídas maiores omitem base64 e incluem um aviso curto—use uma API local, arquivos menores ou endpoints não em lote.

Ferramentas ↔ API REST

Ferramenta 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`

Endpoints de teste, blog, análise e pagamento não são encapsulados (por design).

Relacionados

Produto e documentação: changeimageto.com
Especificação MCP: modelcontextprotocol.io
Problemas e ideias: github.com/vipul510-web/mcp-changeimageto/issues

Licença

MIT