Apolo MCP server
Commit Nov 14, 2026Optimize, convert, and compare images locally in formats like WebP, AVIF, and JPEG XL using an AI agent.
Also known as webcafeina/Apolo
- Stars
- 3
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.1
- Last commit
- Nov 14, 2026
- License
- GPL-3.0
What is Apolo MCP?
Apolo is an MCP server. Optimize, convert, and compare images locally in formats like WebP, AVIF, and JPEG XL using an AI agent.
Summary generated from the project's README
About Apolo MCP server
Optimizing, converting, and comparing images locally on your computer is what Apolo enables through an MCP server. Designed for developers using AI agents like Claude, Cursor, or VS Code, this tool handles formats such as WebP, AVIF, JPEG XL, PNG, and HEIC. It operates entirely on your machine, ensuring privacy by never uploading files to external servers.
Users can instruct an AI client to perform complex batch tasks, such as finding the lightest format for an entire folder or resizing images by a specific percentage. The server integrates official engines like cwebp, avifenc, and cjxl to ensure byte-for-byte accuracy. It also provides quality metrics like SSIMULACRA 2 to help you understand visual loss before saving.
Setup requires installing the Apolo application on macOS, Windows, or Linux. Once installed, the apolo-mcp server can be added to your agent via the command line or specific plugins. The tool supports advanced workflows including vectorizing logos into SVG or PDF and processing large batches in parallel without overwriting original files.
What you can do with it
- 1Batch format conversionConvert an entire folder of images into WebP and AVIF formats simultaneously.
- 2Automated quality optimizationFind the lowest possible file size for an image while maintaining a specific perceived quality level.
- 3Visual loss measurementCompare an original image with a compressed version to see exactly what data was lost.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablewebcafeina/apolo is public and reachablegithub.com/webcafeina/apolo ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/webcafeina/apolo ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubPor 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.
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 | .dmg universal |
| Windows 10 y 11, x64 y ARM | instalador .exe |
| Linux, x64 y ARM | .deb (Debian, Ubuntu), .rpm (Fedora, openSUSE), AppImage o PKGBUILD (Arch) |
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 agentes
En 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 -si
Se 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/Apolo
Los 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 DXF
Má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@webcafeina
O 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 # Linux
Có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:
- Convertir imágenes a WebP
- AVIF, WebP o JPEG XL: cuál usar
- Comprimir imágenes sin perder calidad
- Optimizar imágenes para la web
- Optimizar imágenes con un agente de IA
- Convertir HEIC a JPG
- Vectorizar una imagen
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.
Apolo MCP questions
Does Apolo upload my images?
No, your images never leave your computer; the processing is done locally.
What formats can Apolo handle?
It supports WebP, AVIF, JPEG XL, JPEG, PNG, HEIC, TIFF, GIF, BMP, QOI, and PNM.
Is Apolo free to use?
Yes, Apolo is free and open-source software.