The Image MCP

🖼️ the-image-mcp

Um servidor MCP simples para modelos de IA encontrarem, visualizarem, baixarem e editarem imagens da web.
Alimentado por Chrome DevTools Protocol (CDP) e Pillow. Zero inchaço de Playwright.

⚡ O que ele faz?

1. 🔍 Busca e Visualização

Busca na web (Google Images com fallback automático para Bing) e entrega miniaturas de baixa resolução para a IA, para que ela possa inspecionar imagens candidatas, comparar opções e escolher a vencedora.

2. 🚀 Baixar em Resolução Total

Pega a URL da candidata escolhida e baixa a imagem original, nítida e sem compressão (até 4K+) diretamente para o disco.

3. 🛠️ Editar e Transformar

Ferramenta	O que faz
resize_image	Redimensiona por largura ou altura mantendo a proporção
crop_image	Recorta qualquer caixa delimitadora exata (left, top, right, bottom)
convert_image_format	Converte entre PNG, JPEG, WEBP, BMP, TIFF
rotate_flip_image	Rotaciona em qualquer ângulo ou espelha horizontalmente / verticalmente
apply_image_filter	Aplica blur, grayscale, sharpen, contour ou edge_enhance
get_image_metadata	Inspeciona dimensões, DPI, modo de cor, transparência e tamanho do arquivo

---

🚀 Configuração Rápida

1. Instalar e Executar

Certifique-se de ter o uv instalado:

# Clone and enter the project
git clone https://github.com/phoenix-xr/the-image-mcp.git
cd the-image-mcp

# Sync dependencies
uv sync

# Start the server
uv run images-mcp

---

2. Conectar à Sua IA (Claude, Antigravity, Cursor)

Adicione este bloco ao seu mcp_config.json ou claude_desktop_config.json:

{
  "mcpServers": {
    "the-image-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\anshy\\Documents\\project-gits\\images-mcp",
        "run",
        "images-mcp"
      ]
    }
  }
}

---