ImageMagick MCP: dale a tu asistente de IA un par de manos para redimensionar imágenes

ImageMagick MCP — redimensiona y recorta con un fondo de relleno desenfocado

Los asistentes de IA son excelentes decidiendo cómo debería verse una imagen e inútiles a la hora de producirla realmente. Pídele a uno que "convierta esto en una tarjeta social de 1200×630" y obtendrás un párrafo de consejos en lugar de un archivo. Así que construí imagemagick-mcp: un servidor Model Context Protocol pequeño y rápido, escrito en Go, que envuelve ImageMagick para que cualquier agente compatible con MCP — Claude, Cursor, lo que sea — pueda reencuadrar imágenes a dimensiones exactas en disco.

Todo el punto: darle a tu asistente de IA un par de manos para recortar, redimensionar y rellenar fondos con desenfoque — y que nunca distorsione la fuente.

El único trabajo que hace bien

La mayoría de las herramientas de imágenes o recortan tu sujeto o aplastan la relación de aspecto para encajar en un recuadro. Este servidor se niega a hacer cualquiera de las dos cosas. Cuando la fuente ya coincide con la relación de aspecto objetivo, simplemente redimensiona de forma limpia. Cuando no coincide, tú eliges cómo se rellena el hueco. Nunca hay distorsión.

Esa es la filosofía de diseño — una herramienta, tres modos predecibles, cero sorpresas:

Modo	Qué obtienes	Ideal para
🌫️ `blur` (por defecto)	Imagen ajustada sobre una copia desenfocada y ampliada de sí misma — rellena el hueco de forma vistosa, sin espacio muerto	Miniaturas, tarjetas hero, publicaciones sociales
✂️ `cover`	Recorte para llenar, centrado — sin relleno, sin barras	Avatares, mosaicos, galerías de cuadrícula fija
📦 `contain`	Ajusta dentro con un relleno negro limpio	Logos, capturas de pantalla, arte que no se puede recortar

El modo blur es al que más recurro: en lugar de feas barras negras o un sujeto estirado, obtienes un fondo suave y acorde a la marca derivado de la propia imagen. Es lo que hace que una foto de retrato luzca bien en una tarjeta 16:9.

La herramienta: `crop_resize_blur_bg`

El servidor expone una única herramienta MCP, enfocada. Sin una superficie de API extensa — solo los parámetros que importan:

Parámetro	Tipo	Obligatorio	Por defecto	Descripción
`input_path`	string	✅	—	Ruta absoluta a la imagen fuente
`output_path`	string	✅	—	Ruta absoluta de salida (los directorios padre se crean automáticamente)
`width`	number	✅	—	Ancho objetivo en píxeles
`height`	number	✅	—	Alto objetivo en píxeles
`mode`	string	—	`blur`	`blur`, `cover` o `contain`
`blur`	number	—	`30`	Radio de desenfoque (solo lo usa el modo `blur`)

Como toma rutas absolutas y enteros simples, el modelo puede manejarla a partir de una solicitud en lenguaje natural — "redimensiona todas las fotos de esta carpeta a 1080×1080 con un fondo desenfocado" — y el agente completa los argumentos. Los directorios de salida se crean automáticamente, así que simplemente funciona.

Configuración

Requisitos previos

Go 1.22+ — para compilar el servidor
ImageMagick 7 — el binario magick debe estar en tu PATH

Instala ImageMagick para tu plataforma:

# macOS
brew install imagemagick

# Windows (pick one)
choco install imagemagick
winget install ImageMagick.ImageMagick

En Windows, si usas el instalador en lugar de esto, marca "Add application directory to your system path".

Compilación

El servidor es un único binario de Go. El Makefile cubre todas las plataformas:

make build          # current platform  -> bin/imagemagick-mcp
make build-all      # cross-compile darwin/linux/windows (amd64 + arm64)
make install        # build + copy to /usr/local/bin

Conéctalo a tu cliente MCP

Registra el binario como servidor stdio en la configuración MCP de tu cliente:

{
  "mcpServers": {
    "imagemagick": {
      "command": "/absolute/path/to/bin/imagemagick-mcp"
    }
  }
}

Reinicia el cliente y tu asistente podrá empezar a reencuadrar imágenes.

Por qué envolver ImageMagick en lugar de una librería

ImageMagick ha sido el estándar de oro para la manipulación de imágenes en línea de comandos durante décadas — es rápido, scriptable, y ya está instalado en la mitad de las máquinas que importan. Reimplementar la lógica de recorte y relleno en una librería de imágenes gestionada significaría reinventar matemática geométrica ya probada y heredar una dependencia más pesada. Envolver el binario magick mantiene al servidor pequeño y rápido: se apoya en una herramienta que ya es excelente y simplemente le enseña a hablar MCP.

Ese es el patrón al que sigo volviendo con estos servidores — encontrar un CLI maduro, exponer exactamente la operación que un agente necesita, y poner una interfaz limpia y tipada delante de él. El modelo obtiene una capacidad confiable; tú no obtienes una nueva superficie de ataque ni una reimplementación frágil.

El proyecto está abierto en GitHub: github.com/artschekoff/imagemagick-mcp — construido con Go + ImageMagick. Issues y pull requests bienvenidos.