ImageMagick MCP — redimensionado y recorte de imágenes para agentes de IA

El problema

Los agentes de IA que trabajan con imágenes a menudo necesitan redimensionarlas a dimensiones exactas en píxeles — miniaturas, recortes para redes sociales, relaciones de aspecto específicas de cada plataforma. El enfoque ingenuo es construir un comando de shell, pero eso exige que el agente conozca los flags de la CLI de ImageMagick, gestione correctamente los desajustes de relación de aspecto y produzca resultados limpios en escenarios de desenfoque, recorte y letterbox. Una sola opción incorrecta y el resultado sale distorsionado o vacío.

Opciones consideradas

1. Pedirle al agente que ejecute comandos de shell de ImageMagick directamente — funciona en teoría, pero construir canalizaciones convert correctas para los tres modos de relación de aspecto es propenso a errores y produce resultados inconsistentes entre sesiones del agente.
2. Script en Python con Pillow — fiable, pero requiere un entorno de Python, añade una dependencia y aun así necesita conectarse como herramienta para que el agente la invoque.
3. Servidor MCP en Go que envuelve ImageMagick — elegido. Un binario único y autocontenido; el agente pasa la ruta de entrada, la ruta de salida y las dimensiones; el servidor gestiona internamente toda la lógica de ImageMagick.

Decisión

Un servidor MCP minimalista en Go que expone una herramienta específica: crop_resize_blur_bg. El agente proporciona una ruta de entrada, una ruta de salida, el ancho y alto objetivo y, opcionalmente, un modo. El servidor gestiona el redimensionado — con un tratamiento correcto de la relación de aspecto en todos los casos — y devuelve la ruta de salida al terminar.

Implementación

El servidor envuelve ImageMagick mediante ejecución de shell con una plantilla de comando fija y validada — sin cadenas de CLI construidas por el usuario. Tres modos cubren toda necesidad de composición habitual: blur rellena el fondo con una versión desenfocada de la imagen de origen (modo por defecto, se ve natural para cualquier contenido), cover recorta la imagen para llenar el marco sin relleno, y contain ajusta la imagen dentro del objetivo con relleno sólido. El radio de desenfoque es configurable.

El binario se compila de forma estática y se genera de forma cruzada para macOS, Linux y Windows (amd64 + arm64). Sin dependencias de tiempo de ejecución más allá del propio ImageMagick. Se integra con cualquier host compatible con MCP mediante una sola entrada en la configuración de servidores del host.

Resultado

Redimensionar imágenes dentro de un flujo de trabajo de agente ahora se reduce a una sola llamada determinista a una herramienta. El agente ya no necesita conocer la API de ImageMagick — especifica la intención (dimensiones, modo), y el servidor produce un resultado correcto en cada ocasión. Las canalizaciones de redimensionado por lotes encadenan varias llamadas sin ninguna intervención manual.