Image MCP

Redimensiona, convierte, comprime, recorta, crea miniaturas y añade marcas de agua a imágenes desde el chat: sin subidas, sin cuenta, sin dependencias nativas. Cada archivo permanece en tu máquina.

GitHubPrueba este MCPPatrocinado

Documentación

mcp-image

Servidor MCP para redimensionamiento, conversión, compresión y marca de agua de imágenes. Redimensiona, convierte, comprime y añade marcas de agua a imágenes, JavaScript puro.

Funciona con Claude Desktop, Claude Code, Cursor y cualquier cliente del Model Context Protocol. Se ejecuta en tu propia máquina, o alojado sin necesidad de instalación.

Página del producto: https://mcp.zovo.one/s/image — qué hace, las herramientas que expone y un endpoint de token en vivo.

Instalación

Alojado, nada que instalar. Obtén un token de https://mcp.zovo.one/mcp/connect (la página de conexión) o https://mcp.zovo.one/mcp/token (el mismo token como JSON); se emite uno anónimo gratuito al momento y una clave Pro funciona de la misma manera. Luego apunta un cliente MCP a https://mcp.zovo.one/mcp/image a través de streamable-http y envía el token como Authorization: Bearer <token>.

Si tu cliente no puede configurar cabeceras, coloca el token en la ruta en su lugar: https://mcp.zovo.one/mcp/image/t/<token>. Ambas formas funcionan. La URL desnuda sin token responde 401 en tools/call, por lo que el token no es opcional.

Claude Desktop, un clic. Descarga image.mcpb desde la última versión y haz doble clic en él.

Desde el código fuente. El espejo es autónomo: cada dependencia @theluckystrike/* está incluida, por lo que un clon nuevo se compila sin configuración adicional.

git clone https://github.com/theluckystrike/mcp-image.git
cd mcp-image
npm install && npm run build

Luego apunta tu cliente al punto de entrada compilado:

{
  "mcpServers": {
    "image": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-image/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-image aún no está publicado en npm, por lo que un comando npx -y @theluckystrike/mcp-image fallará. Las tres rutas anteriores son las que funcionan y cada una es probada por CI.

image demo

Espejo de solo lectura de mcp-servers/servers/image. Ver MIRROR.md.

Di "haz estas cinco fotos de 1200 píxeles de ancho" o "reduce esta captura de pantalla y elimina el GPS" y sucede, en tu máquina, en un segundo. Este servidor MCP hace los trabajos pequeños de imágenes que de otro modo te enviarían a un cargador web: redimensionar, convertir entre PNG, JPEG, BMP, GIF y TIFF, comprimir con un recuento real de bytes antes y después, recortar, crear miniaturas de una carpeta, añadir marcas de agua con el nombre de tu negocio y eliminar el bloque EXIF que una cámara de teléfono escribe en cada foto. Sin subida, sin cuenta, sin dependencia nativa, sin editor de imágenes.

En el Registro oficial de MCP (io.github.theluckystrike/image-resize-convert-compress-watermark).

Listado en el Índice de Productos de IA — endpoint remoto en vivo en mcp.zovo.one/s/image, nivel gratuito, sin registro.

Las tareas de imágenes de un negocio independiente, hechas desde el chat en lugar de desde una pestaña del navegador a la que preferirías no entregar una foto de un cliente.

Instalación en 60 segundos

La publicación en npm para @theluckystrike/mcp-image está pendiente. Hasta entonces, el paquete de un clic .mcpb o un clon + compilación es la ruta que funciona, ambas verificadas a continuación.

Un clic (.mcpb): descarga image.mcpb desde la última versión y haz doble clic en él en Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

(claude_desktop_config.json):

{
  "mcpServers": {
    "image": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-image"]
    }
  }
}

Claude Code:

claude mcp add image -- npx -y @theluckystrike/mcp-image

(.cursor/mcp.json):

{
  "mcpServers": {
    "image": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-image"]
    }
  }
}

La forma npx anterior comienza a funcionar en el momento en que se publica el paquete. Hasta entonces, usa el paquete .mcpb anterior, o compila desde el código fuente con exactamente estos tres comandos:

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers
npm install
npm run build -w packages/mcp-license -w servers/image

Luego apunta el command de tu cliente a node con un argumento: la ruta absoluta a servers/image/dist/index.js.

Para ejecutar en modo Pro, configura MCP_LICENSE_KEY en el mismo bloque de configuración, o llama a license_activate una vez con tu clave.

Herramientas

Herramienta	Qué hace
`image_info`	Formato, dimensiones en píxeles, megapíxeles, relación de aspecto, tamaño de archivo en bytes, si la imagen lleva canal alfa y los bytes que gasta por píxel
`image_resize`	Una copia redimensionada. `inside` cabe dentro del recuadro y mantiene la proporción, `cover` llena el recuadro y recorta el exceso, `exact` estira. Da uno de ancho o alto y el otro lo sigue
`image_convert`	Re-codifica como PNG, JPEG, BMP, GIF o TIFF. La transparencia que va a JPEG se aplana sobre blanco, y la respuesta lo dice
`image_compress`	Menos bytes, con el recuento antes y después y el porcentaje ahorrado. `quality` (por defecto 80), `max_width` y `max_bytes` para alcanzar un tamaño objetivo en una sola llamada
`image_crop`	Corta un rectángulo: `x`, `y` desde la esquina superior izquierda, `width`, `height`. Un rectángulo que pasa de un borde se rechaza con el tamaño real, nunca se recorta silenciosamente
`image_thumbnails`	Una miniatura por archivo en `out_dir`, cada una cabiendo dentro de `size` por `size` y manteniendo su relación de aspecto
`image_watermark`	Texto sobre la imagen en una esquina y una opacidad, blanco sobre una placa translúcida. Sin texto, el nombre de tu negocio del perfil compartido mcp-invoice y mcp-docx escriben
`image_strip_metadata`	Una copia con píxeles y nada más: EXIF, GPS, cámara, hora de captura, XMP y perfiles de color no se transfieren
`image_batch_resize`	Redimensiona una lista completa en `out_dir`, cada una manteniendo su propia relación de aspecto, nombradas `<name>-<W>x<H>.<ext>`
`image_dominant_colors`	Los colores que cubren la mayor parte de una imagen, como códigos hex con la proporción de píxeles que cubre cada uno. Gratis: 3; Pro: hasta 16
`license_status`	Muestra el modo gratuito o Pro
`license_activate`	Activa una clave Pro (verificada sin conexión)

Recurso: image://recent devuelve las últimas 25 operaciones, las más recientes primero, con las entradas, los archivos escritos y cuándo. Prompt: prepare_for_web reduce una imagen de tamaño de cámara a un JPEG de tamaño de página, elimina los metadatos que venían con ella e informa los bytes ahorrados.

Lo que puedes decir

Tú dices	Herramienta
"¿Qué tan grande es esta imagen y tiene transparencia?"	`image_info`
"Haz esto de 1200 píxeles de ancho."	`image_resize`
"Convierte este PNG a JPEG."	`image_convert`
"Esta foto pesa 8 MB, haz que pese menos de un megabyte."	`image_compress`
"Recorta el banner superior de esta captura de pantalla."	`image_crop`
"Haz miniaturas de todo lo que hay en esta carpeta."	`image_thumbnails`
"Pon el nombre de mi empresa en la esquina de esta foto."	`image_watermark`
"Elimina las coordenadas GPS antes de que envíe esto."	`image_strip_metadata`
"Redimensiona todos estos a 1600 de ancho."	`image_batch_resize`
"¿De qué colores está hecho este logotipo?"	`image_dominant_colors`
"Prepáralo para el sitio web."	`prepare_for_web` prompt

Ejemplo práctico

You: This photo is too big for the site. Get it to 1600 wide and drop the metadata.

  image_info { path: "~/photos/DSC_0491.jpg" }
  -> 6000x4000, 24 MP, JPEG, 8.4 MB, no alpha

  image_compress {
    path: "~/photos/DSC_0491.jpg",
    max_width: 1600,
    quality: 80,
    max_bytes: 256000,
    out_path: "~/photos/DSC_0491-web.jpg"
  }
  -> 8.4 MB -> 243.7 KB (8809124 -> 249556 bytes, -97.2%)
  -> Method: JPEG quality 62 (searched down from 80 in 5 encodes to fit 250.0 KB)
     and a resize to 1600 px wide
  -> ~/photos/DSC_0491-web.jpg, 1600x1067, JPEG

La re-codificación JPEG también elimina el bloque EXIF que escribió la cámara, incluidas las coordenadas GPS. El archivo original permanece sin cambios byte a byte.

Gratis vs Pro

	Gratis	Pro
`image_info`	Ilimitado, a cualquier tamaño	Ilimitado
`image_resize`, `image_convert`, `image_compress`, `image_crop`	Cualquier fuente, escribiendo salidas de hasta 4 MP (2000x2000 y un poco más)	Cualquier tamaño, hasta los límites de entrada de 50 MB / 10,000 px
`image_strip_metadata`	Cualquier tamaño	Cualquier tamaño
`image_thumbnails`, `image_batch_resize`	Hasta 5 archivos por llamada, salidas de hasta 4 MP cada una	Cualquier número de archivos, cualquier tamaño
`image_watermark`	El nombre de tu negocio del perfil compartido	Cualquier texto que pases
`image_dominant_colors`	Los 3 colores principales	Hasta 16

El límite gratuito está en lo que se escribe, no en lo que se lee: una foto de teléfono de 12 MP reducida a 1600 px de ancho es una llamada gratuita, porque ese es el trabajo. Escribir 12 MP de vuelta es la Pro.

Un límite de nivel es una respuesta, no un error, y no se escribe nada cuando se rechaza una llamada.

Pro es un pago único de $19, o $39 por todos los servidores de la colección, de por vida.

`quality` es un parámetro de JPEG, y solo un parámetro de JPEG

Esta es la única cosa sobre la compresión de imágenes que sorprende a la gente, por lo que el servidor lo dice en su propia respuesta en lugar de aceptar un número y no hacer nada con él silenciosamente. Un JPEG descarta detalles para hacerse más pequeño, y quality es el dial para cuánto. Un PNG no tiene pérdidas: no hay dial. Pasar quality: 40 a una salida PNG no hace que un PNG sea 60% más pequeño, hace exactamente el mismo PNG.

Entonces, el formato de salida sigue la extensión de tu out_path, y esa es la palanca:

out_path: "shot-small.jpg", quality se aplica, y una foto típicamente baja 80-95%.
out_path: "shot-small.png", quality se informa como no aplicable, y solo max_width elimina bytes.

La cuantización de paleta se midió como alternativa para PNG y se rechazó: re-codificar un PNG ruidoso de 300x220 a través de un cuantizador de 16 colores produjo un archivo más grande (115,451 bytes contra 39,262), porque el codificador aquí escribe RGBA de cualquier manera y la cuantización solo destruye la similitud fila a fila que el paso de deflación estaba explotando. Una herramienta que afirma comprimir y devuelve un archivo más grande es peor que una herramienta que dice qué perilla existe.

image_compress por lo tanto siempre informa el recuento de bytes antes y después, el porcentaje y el método que hizo el trabajo, y, si la salida resultó más grande, lo dice y te dice que conserves el original.

Las bombas de descompresión se rechazan desde la cabecera, antes de que se decodifique nada

Un PNG de 4 KB puede declarar que es de 20,000 por 20,000 píxeles. Decodificarlo asigna 1.6 GB de RGBA y tumba el proceso antes de que cualquier verificación de tamaño escrita después de la decodificación pudiera ejecutarse. Así que las dimensiones declaradas se leen de la cabecera del contenedor, PNG IHDR, el segmento SOF de JPEG, el descriptor de pantalla lógica de GIF, la cabecera de información de BMP, el primer IFD de TIFF, y un archivo de más de 10,000 px por lado se rechaza allí, con la memoria que habría tomado nombrada en el mensaje:

Error: /path/bomb.png declares 20000x20000 pixels in its PNG header and was refused before decoding:
this server caps a side at 10000 px. A small file that declares an enormous canvas is a decompression
bomb - decoding it would allocate 1526 MB of RGBA. Nothing was decoded.

El tamaño decodificado se verifica de nuevo después, porque una sonda de cabecera puede volver vacía en un TIFF inusual, y un guardián que solo se ejecuta a veces no es un guardián.

Los archivos existentes nunca se sobrescriben y las entradas nunca se modifican

Cada herramienta escribe un archivo nuevo y deja sus entradas byte a byte intactas, no hay modo en el lugar, a propósito. Un out_path que ya existe se rechaza:

Error: /path/shot-small.png already exists and nothing was written.
Pass overwrite: true to replace it, or give a different out_path.

La ruta se reserva con una creación exclusiva, no con una verificación de existencia, por lo que dos procesos escribiendo el mismo out_path al mismo tiempo no pueden pisarse entre sí: uno gana, el otro se rechaza y no escribe nada. image_thumbnails y image_batch_resize reservan cada una de sus rutas de salida antes de escribir cualquiera de ellas, por lo que una colisión en el archivo 3 no deja los archivos 1 y 2 atrás como un lote a medio hacer, y las reservas se liberan, por lo que tampoco queda nada vacío en el disco.

Pasa overwrite: true cuando reemplazar el archivo es lo que quieres.

overwrite: true todavía no permite que una salida sea una entrada. Escribir un resultado de vuelta sobre una de sus propias fuentes destruye esa fuente, los píxeles ya están decodificados en memoria y se escriben sobre el archivo del que vinieron, por lo que un original de 4000 px se convierte en la miniatura de 512 px y cada lectura posterior de esa ruta está silenciosamente mal. Así que un out_path que resuelve a (o comparte un inodo con) cualquier entrada de la misma llamada se rechaza antes de que ocurra cualquier trabajo.

Lo que "eliminar metadatos" realmente hace

image_strip_metadata decodifica la imagen y la re-codifica desde los píxeles crudos. EXIF, coordenadas GPS, la cámara y el objetivo, la hora de captura, paquetes XMP y perfiles de color incrustados no se eliminan uno por uno, simplemente nunca se entregan al codificador, por lo que no pueden salir por el otro lado. Dos consecuencias que vale la pena conocer:

Los píxeles son los mismos, los bytes no. Un JPEG pasa por el codificador una segunda vez, por lo que la copia no es bit-idéntica al original aunque se vea igual. Conserva el original si eso importa.
Cada otra herramienta de escritura aquí tiene el mismo efecto como efecto secundario. Redimensionar una foto también elimina su EXIF.

Límites

Las entradas de más de 50 MB se rechazan: una imagen se decodifica a ancho x alto x 4 bytes de RGBA sin procesar, sin importar lo bien comprimida que esté en disco.
10,000 px por lado, verificado primero desde la cabecera y segundo desde la decodificación.
Leídos y escritos: PNG, JPEG, BMP, GIF y TIFF, detectados por bytes mágicos en lugar de por extensión de archivo. Sin WebP, sin AVIF, sin HEIC, sin SVG; no hay un decodificador puramente en JavaScript para esos formatos que valga la pena incluir, y este servidor no tiene dependencias nativas.
Un GIF animado se lee como su primer fotograma. Este servidor no maneja animaciones.
El texto de la marca de agua se dibuja con las caras bitmap Open Sans incluidas (8, 16, 32, 64 y 128 px), y se elige la más grande que quepa en la imagen. Un carácter que esas caras no incluyan no se dibuja, por lo que no hay marca de agua CJK.
Sin rotación, sin filtros, sin corrección de color, sin OCR, sin eliminación de fondo. Este servidor hace los trabajos de tamaño y formato; no es un editor de imágenes.

Cómo almacena datos

Solo un registro de lo que hizo: ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/image/operations.json, las últimas 500 operaciones, como JSON plano. Tus imágenes permanecen donde las pongas. Cada escritura en el registro se ejecuta dentro de un bloqueo de asesoramiento en .../image/.lock, por lo que dos clientes en un mismo directorio de datos no pueden perder un registro, y los guardados van a un archivo temporal y se renombran en su lugar.

Si el registro es ilegible o no es JSON válido, nunca se trata como "vacío": se mueve a un lado byte por byte como operations.json.corrupt-<timestamp> con un marcador junto a él. La imagen que solicitaste aún se escribe, el archivo está en disco antes de tocar el registro, y la respuesta te indica que el historial no pudo actualizarse.

La marca de agua lee el perfil compartido que usa toda la suite, ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/profile/business.json, escrito por business_set en mcp-invoice o mcp-docx. Nada se inventa: sin nombre almacenado y sin texto pasado, image_watermark se niega y dice qué herramienta ejecutar.

Privacidad

Todos los datos permanecen locales. El servidor lee y escribe archivos en tu máquina y no realiza ninguna solicitud de red de ningún tipo: ni para licencias (las claves se verifican sin conexión), ni para fuentes, ni para telemetría. Una foto de cliente que redimensiones nunca se sube a ningún lugar, que es la razón completa de que esto exista.

Se combina con

mcp-docx, redimensiona un logotipo aquí, luego ponlo en el membrete: image_resize a la altura del encabezado, luego el escritor .docx recoge el archivo del disco.
mcp-pdf, reduce los escaneos antes de fusionarlos, para que el PDF combinado no pese 40 MB.
mcp-resume, una foto de rostro correctamente dimensionada y sin metadatos para el CV y el formulario de solicitud.
office-suite, varios servidores detrás de una sola instalación, una entrada de configuración.

Solución de problemas

npx se cuelga o no encuentra el paquete: la publicación npm de este paquete está pendiente. Usa el paquete .mcpb o la ruta de clonar y compilar anterior hasta que se publique.
"la calidad no se aplica a una salida PNG": escribe a un .jpg out_path, o pasa max_width. Consulta la sección anterior.
"declara NxN píxeles ... y fue rechazado antes de decodificar": el archivo afirma un lienzo de más de 10,000 px por lado. Si es genuinamente tan grande, redimensiona con una herramienta que transmita mosaicos; este servidor decodifica imágenes completas.
"no comienza con los bytes mágicos": el archivo no es PNG, JPEG, BMP, GIF o TIFF. Un nombre .png en un archivo WebP es la causa habitual; conviértelo primero.
"ya existe y no se escribió nada": pasa overwrite: true, o un out_path diferente.
La marca de agua es diminuta: la cara incluida más grande es de 128 px, y se elige para que quepa dentro del 80% del ancho de la imagen. En una foto muy grande, redimensiona primero y aplica la marca de agua después.
Versión de Node: requiere Node >= 18. Verifica con node -v.

Licencia MIT. Soporte: support@zovo.one

Construido por theluckystrike.

Usa estos documentos como servidor MCP

Cualquier cliente MCP (Claude, Cursor, Windsurf, VS Code) puede leer la documentación de este repositorio directamente a través de GitMCP, sin instalación:

URL de Docs MCP: https://gitmcp.io/theluckystrike/mcp-image