Apolo
Apolo's MCP server lets an AI agent optimize, convert, compare and measure images locally on your machine, without uploading anything.
Inspect an image or folder: format, dimensions, size, transparency, metadata, EXIF orientation (
analizar_imagen).Optimize a single image to WebP, JPEG, PNG, QOI, AVIF or JPEG XL, with fixed quality or a target SSIMULACRA 2 score, plus resizing, cropping, palette reduction and presets (
optimizar_imagen).Compare formats at equal perceived quality and save the lightest, all or none (
comparar_formatos).Batch convert folders or many images in the background, optionally keeping only the lightest per image, then follow or cancel it (
empezar_lote,ver_lote,cancelar_lote).Measure quality against the original with SSIMULACRA 2, PSNR and SSIM (
medir_calidad).View images: scaled preview, an area at 1:1 to spot defects, or a difference/structure map against the original (
ver_imagen).Manage presets: list saved ones and create new ones shared with the app and CLI (
listar_presets,guardar_preset).Check the setup: version, launch origin and bundled engines (
acerca_de_apolo).
Por qué Apolo
Ves lo que pierdes antes de guardar. Comparas el original y el resultado con un deslizador, lado a lado o con un mapa de diferencias, y Apolo te da la nota SSIMULACRA 2 de cada uno.
El mismo fichero que las herramientas oficiales, byte a byte:
cwebp,cjpeg(MozJPEG),oxipng,avifencycjxlvan dentro, con todas sus opciones, y Apolo te da la orden equivalente.Calidad por nota. Pide que no se note, y Apolo busca la calidad más baja que lo consigue, foto a foto.
Carpetas enteras: lotes en paralelo, varios formatos a la vez, el más ligero de cada foto, un tamaño para todas, y nunca sobrescribe nada.
Recortar y redimensionar sobre la imagen, por el lado mayor, un porcentaje o ancho y alto.
Abre las fotos del iPhone (HEIC), además de PNG, JPEG, WebP, AVIF, JPEG XL, TIFF, GIF, BMP, QOI y PNM.
Hecha para cada sistema: Liquid Glass en macOS, Fluent y Mica en Windows, Adwaita en GNOME y Breeze en KDE. En español y en inglés.
Privada y ligera: tus imágenes no salen de tu ordenador, y con fotos de 24 megapíxeles no pasa de unos 2 GB de memoria.
Vectoriza: pasa un logotipo, un icono o un dibujo a SVG, PDF, EPS o DXF, con su nota, sin perder la transparencia. También para cortar vinilo o láser.
Con tu agente de IA: Claude, Cursor o VS Code optimizan por ti con su servidor MCP.
Related MCP server: ollama-vision-mcp
Descargar
La forma más fácil es apolo.webcafeina.com: sabe qué ordenador
tienes y te da su descarga. Todos los ficheros están en la
última versión, con su suma en
SHA256SUMS.txt.
Sistema | Aplicación |
macOS 11+, Apple Silicon e Intel |
|
Windows 10 y 11, x64 y ARM | instalador |
Linux, x64 y ARM |
|
Con Homebrew, en macOS y Linux:
brew install --cask webcafeina/apolo/apolo # la aplicación (macOS)
brew install webcafeina/apolo/apolo # la línea de comandos y el servidor para agentesEn Linux, con el repositorio (firmado con la clave de Apolo), se actualiza con el resto del sistema:
# Debian y Ubuntu
sudo install -dm755 /etc/apt/keyrings
sudo curl -fsSLo /etc/apt/keyrings/apolo.asc https://apolo.webcafeina.com/apolo.asc
sudo curl -fsSLo /etc/apt/sources.list.d/apolo.sources https://apolo.webcafeina.com/apt/apolo.sources
sudo apt update && sudo apt install apolo
# Fedora
sudo curl -fsSLo /etc/yum.repos.d/apolo.repo https://apolo.webcafeina.com/rpm/apolo.repo
sudo dnf install apolo
# openSUSE
sudo zypper addrepo https://apolo.webcafeina.com/rpm/apolo.repo
sudo zypper install apolo
# Arch, Manjaro, EndeavourOS, CachyOS (pronto en el AUR, como apolo-bin)
mkdir apolo && cd apolo
curl -fsSLO https://apolo.webcafeina.com/aur/PKGBUILD
makepkg -siSe actualiza sola: cuando hay una versión nueva, Apolo lo avisa y se instala con un clic.
La primera vez, como los instaladores no están firmados, el sistema avisa:
macOS: en Ajustes del Sistema › Privacidad y seguridad, pulsa «Abrir igualmente». Si dice que está dañada:
xattr -dr com.apple.quarantine /Applications/Apolo.app.Windows: en SmartScreen, «Más información» › «Ejecutar de todos modos».
Verificar la descarga
Cada fichero de la versión trae su suma SHA-256 en SHA256SUMS.txt y su procedencia firmada por
GitHub (qué compilación lo hizo y desde qué commit). Con la línea de comandos de GitHub:
gh attestation verify Apolo_1.0.0_universal.dmg --repo webcafeina/ApoloLos repositorios APT y RPM y los .rpm van firmados con la clave GPG
6D95 3C94 D0D6 6AB6 B9B0 FA26 CA21 CD7A B7FA 57FC. Cómo avisar de un fallo de seguridad, en
SECURITY.md.
En la terminal
La línea de comandos apolo hace lo mismo que la aplicación, con las opciones de cada herramienta
oficial y los mismos presets:
apolo webp -q 80 foto.png -o foto.webp # como cwebp
apolo avif -q 60 foto.png foto.avif # como avifenc
apolo lote fotos/ --formato webp,avif --objetivo 80 # carpetas enteras, por nota
apolo lote fotos/ --mas-ligero --formato webp,avif,jpeg --lado-mayor 1920
apolo medir foto.png foto.webp # SSIMULACRA 2, PSNR y SSIM
apolo vectorizar logo.png -o logo.svg # a SVG, PDF, EPS o DXFMás ejemplos en la página de la línea de comandos.
Con un agente de IA
Apolo se usa desde Claude, Cursor, VS Code y cualquier agente que hable MCP: analiza, optimiza, compara formatos a la misma calidad percibida, mide la pérdida, convierte carpetas y vectoriza, en tu ordenador. Nunca sobrescribe ni borra.
El servidor, apolo-mcp, va dentro de la aplicación y se actualiza con ella. En Apolo, la fila
MCP de la barra lateral tiene lo que hay que copiar para cada agente y la extensión de Claude
Desktop. En Claude Code y Cowork, lo más cómodo es el plugin, que además le enseña a Claude
cuándo usar Apolo (necesita Node.js 18 o más; está en empaquetado/claude):
/plugin marketplace add webcafeina/Apolo
/plugin install apolo@webcafeinaO a mano, en Claude Code:
claude mcp add --scope user apolo -- "/Applications/Apolo.app/Contents/MacOS/apolo-mcp" # macOS
claude mcp add --scope user apolo -- "%LOCALAPPDATA%\Apolo\apolo-mcp.exe" # Windows
claude mcp add --scope user apolo -- /usr/bin/apolo-mcp # LinuxCómo conectarlo en cada agente, en la página de agentes; qué pedirle, en la guía; y las doce herramientas, en docs/mcp/catalogo.md. Lo que el agente pide (rutas, nombres, miniaturas) entra en su conversación, y lo ve el proveedor del modelo: todo, en la página de privacidad.
Guías
Con cifras medidas por Apolo sobre 24 fotos de uso libre:
Y Apolo frente a otras herramientas, en las comparativas.
Preguntas
¿Es gratis? ¿Sube mis imágenes? ¿Por qué avisa el sistema? Las respuestas, en las preguntas frecuentes. Y lo que trae cada versión, en novedades.
Compilar
Hace falta:
Rust estable, Node 22 y pnpm;
CMake, nasm y clang (libjxl se compila con clang, como el
cjxloficial);en Linux, además,
libwebkit2gtk-4.1-dev librsvg2-dev libssl-dev pkg-config.
Clona con submódulos: git clone --recurse-submodules.
make comprobar # formato, clippy, pruebas, interfaz y web
make equivalencia # el mismo fichero que cwebp, cjpeg, oxipng, qoiconv, avifenc y cjxl
make cli # la línea de comandos
make mcp # el servidor para agentes, apolo-mcp
make app # la aplicación (con apolo-mcp dentro)Licencia
GPLv3. Apolo es software libre: puedes usarlo, estudiarlo, cambiarlo y compartirlo. Los motores que lleva dentro tienen sus propias licencias, todas compatibles:
Licencia | Motores |
BSD | libwebp, MozJPEG, libavif, aom, libyuv y libjxl |
MIT | OxiPNG |
GPLv3 | libimagequant |
LGPLv3 | libheif y libde265 |
Apache-2.0 | highway, sjpeg y rmcp |
MIT o Apache-2.0 | sys-locale |
Hecho por Webcafeína.
Available Tools
12 toolsacerca_de_apoloARead-onlyIdempotent
Which version of Apolo is answering, where it starts from (the app, or the Claude Desktop extension handing over to it) and the engines it carries (libwebp, MozJPEG, oxipng, avifenc, cjxl). For when someone asks about the version or something doesn't match what was expected.
Inputs: no named parameters.
analizar_imagenARead-onlyIdempotent
What an image is (format, dimensions, size, transparency, metadata, EXIF orientation) or which images a folder holds. Use it first if you don't know what it is. It doesn't measure quality: for that, medir_calidad. Example: {"ruta": "~/Photos/beach.heic"}
Inputs: ruta (required).
cancelar_loteAIdempotent
Stops a batch. What has already been converted stays. Example: {"id": "l-1"}
Inputs: id (required).
comparar_formatosA
Encodes the same image in several formats at the same perceived quality (SSIMULACRA 2 score, 80 by default) and says which one is the lightest. Saves the best one (by default), all or none, always as new files. It takes a while: about 7 trials per format (with a 12 MP photo, over a minute; with 24 MP, about three). With photos over about 20 MP, better use empezar_lote with that image, the formats and mas_ligero: it does the same in the background and isn't cut off by a timeout, although it only gives the winner. For a single output already decided, optimizar_imagen. Example: {"ruta": "~/a.png", "formatos": ["webp", "avif", "jxl"]}
Inputs: ruta (required), alto, ancho, paleta, +8 more.
empezar_loteA
Converts folders or many images in the background, subfolders included, without overwriting anything, and comes back right away with an id. By default, WebP at score 80, in a folder next to the input one (photos-webp, or photos-apolo with several formats); with loose images, in a subfolder next to them (webp/, apolo/). One at a time. Afterwards, ver_lote. Example: {"entradas": ["~/Photos/trip"], "formatos": ["webp", "avif"], "mas_ligero": true}
Inputs: entradas (required), alto, ancho, medir, +12 more.
guardar_presetA
Saves a combination of format and options as a new preset, to use in Apolo, on the command line or here. It doesn't overwrite: if the name exists, it's an error (changing or deleting presets is done in Apolo). Example: {"nombre": "Light web", "formato": "avif", "nota_objetivo": 75, "ancho": 1920}
Inputs: nombre (required), alto, ancho, orden, +10 more.
listar_presetsARead-onlyIdempotent
Apolo's saved presets (the same ones as the app and the command line), with their format and their command. They are used with preset in optimizar_imagen and empezar_lote.
Inputs: no named parameters.
medir_calidadARead-onlyIdempotent
How far an image is from its original: SSIMULACRA 2 (90 or more indistinguishable, 80 very high, 70 high, 50 noticeable), PSNR and SSIM. They have to be the same size (if the result is auto-rotated, the original is auto-rotated too). To see where the loss is, ver_imagen with diferencias_con. Example: {"original": "/a.jpg", "resultado": "/a.webp"}
Inputs: original (required), resultado (required).
optimizar_imagenA
Optimizes an image and saves it as a NEW file (next to the original, or in salida; if the name exists, -2, -3…). Without a quality, it searches for the lowest one that gives a SSIMULACRA 2 score of 80. Gives the equivalent command for cwebp, cjpeg, oxipng, avifenc or cjxl. To choose between formats, comparar_formatos; for many images, empezar_lote. Examples: {"ruta": "/a.jpg"} · {"ruta": "/a.png", "formato": "avif", "nota_objetivo": 85} · {"ruta": "~/a.jpg", "formato": "webp", "orden": "-q 80 -m 6", "ancho": 1600} For the person's images, use it instead of converting them yourself in another environment (a cloud interpreter): it works with the file on their disk, with the official engines. Apolo doesn't see images attached to the conversation: if one is attached, ask for its path.
Inputs: ruta (required), alto, ancho, medir, +12 more.
vectorizar_imagenA
Vectorizes: turns a logo, icon, illustration or drawing into SVG, PDF, EPS or DXF, and saves it as a NEW file (next to the original, or in salida). It detects the kind of image, measures the preview with SSIMULACRA 2 and, with nota_objetivo, searches for the lightest drawing that gets there. Transparency stays transparent. To cut vinyl or laser, estilo trazar_bordes and, in DXF, nivel_dxf. With photos it gives a poster of flat colors. Examples: {"ruta": "/logo.png"} · {"ruta": "/logo.png", "salida": "/logo.pdf", "colores": 3} · {"ruta": "/icon.png", "formato": "dxf", "estilo": "trazar_bordes", "nivel_dxf": "arcos"}
Inputs: ruta (required), tipo, estilo, grosor, +9 more.
ver_imagenARead-onlyIdempotent
Returns the image to look at: scaled down (768 px by default), an area at full size to spot defects, or the map of differences from its original (diferencias_con). Each view uses up context: ask for one only when it helps. Examples: {"ruta": "/a.webp"} · {"ruta": "/a.webp", "diferencias_con": "/a.jpg"} · {"ruta": "/a.webp", "zona": {"x": 400, "y": 300, "ancho": 256, "alto": 256}}
Inputs: ruta (required), zona, lado_max, tipo_mapa, +1 more.
ver_loteARead-onlyIdempotent
How a batch is going: the new images since “desde”, and the summary when it ends. With esperar_segundos (up to 25) it waits until there is something new, instead of asking in a loop. Example: {"id": "l-1", "esperar_segundos": 20}
Inputs: id (required), desde, esperar_segundos.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct action/resource: optimizing, measuring quality, viewing, vectorizing, analyzing, comparing formats, and batch start/status/cancel are all clearly separated. Descriptions explicitly route between the easily-confused pairs (optimizar_imagen vs comparar_formatos vs empezar_lote; analizar_imagen vs medir_calidad; ver_imagen vs analizar_imagen), leaving no realistic misselection.
Names follow a Spanish verb_noun pattern (guardar_presets, medir_calidad, optimizar_imagen, empezar_lote, cancelar_lote, ver_lote), which is readable and predictable. The only deviation is acerca_de_apolo, a noun phrase rather than an action, so consistency is strong but not perfect.
Twelve tools is well within a healthy range and every tool maps to a real function: single-image ops, quality measurement, format comparison, vectorization, presets, and batch lifecycle. Nothing feels padded and nothing core is missing from the count.
Coverage is broad: analyze, view, optimize, measure, compare, vectorize, plus batch start/status/cancel and preset save/list. The main gap is preset lifecycle — no update or delete — which is deliberately deferred to the desktop app, and there is no way to enumerate active batches, but these are minor and workable.
Maintenance
Related MCP Connectors
Image and PDF toolkit: convert to AVIF/WebP/JXL, resize, crop, remove backgrounds, optimize PDFs.
Compress, convert, resize, crop, upscale, OCR and remove backgrounds from images.
Compress, convert and resize images, and scan web pages for every image they load.
Resize, convert to WebP, compress, crop, rotate and strip EXIF from images
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables local image analysis using Ollama AI models with complete privacy protection. Supports image content analysis, OCR text extraction, UI design analysis, and batch processing without requiring API keys or uploading data.1MIT
- FlicenseNot gradedqualityDmaintenanceEnables text-only AI models to analyze images via local Ollama multimodal models. Supports image analysis, OCR, and multi-image comparison entirely offline.-
- AlicenseNot gradedqualityDmaintenanceAnalyzes images via OpenAI-compatible vision APIs, returning structured JSON for layout, components, colors, typography, and issues, with tools for single image analysis, comparison, and clipboard image analysis.MIT
- AlicenseNot gradedqualityCmaintenanceProvides local image understanding for text-only LLMs with tools for image analysis, OCR, object detection, and cropping, all processed on-device.2MIT