# Apolo

> Apolo is an open-source MCP server for design and media. Optimize, convert and compare images locally from Claude, Cursor or VS Code. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://apolo.webcafeina.com/en/agents/
- **Repository:** https://github.com/webcafeina/apolo
- **MCP Registry name:** io.github.webcafeina/apolo
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

The MCP server is built into Apolo, a desktop image optimizer, so your agent drives the same engines the app uses and your images stay on your computer. The server ships inside the app and updates with it.

It can analyze an image or a folder, optimize one image and show the equivalent cwebp, cjpeg, oxipng, avifenc or cjxl command, compare formats at the same perceived quality and measure the loss with SSIMULACRA 2. It also crops, resizes and previews images, converts whole folders in batches and saves presets. It never overwrites or deletes: results are always new files.

Install is a one-time MCPB extension for Claude Desktop, a Claude Code plugin that needs Node.js 18 or newer, or a manual command per client. What the agent asks for, such as paths, names and thumbnails, enters the conversation and is visible to the model provider.

## Features

- **Format comparison:** Compare WebP, AVIF, JPEG XL, JPEG and PNG at the same perceived quality.
- **SSIMULACRA 2 scoring:** Measure how much quality an optimization loses.
- **Equivalent commands:** See the cwebp, cjpeg, oxipng, avifenc or cjxl command behind a result.
- **Batch conversion:** Convert whole folders and save presets.
- **Never overwrites:** Writes new files instead of replacing or deleting originals.
- **Crop and resize:** Adjust and preview images from the agent.

## Good for

- Shrink a folder of site images to WebP or AVIF
- Pick the lightest format that still looks the same
- Resize photos by longest side before upload
- Audit a folder for oversized images

## Install

### Claude Code (Terminal)

```sh
claude mcp add apolo -- npx -y https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apolo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apolo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apolo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apolo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apolo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb"
      ]
    }
  }
}
```

## FAQ

### Do my images leave my computer?

No, they are processed locally; only what the agent requests, like paths and thumbnails, goes into its conversation.

### Does it overwrite originals?

No. It always writes new files.

### Which platforms are supported?

macOS, Windows and Linux, in x64 and ARM builds.

### Is Apolo free?

The README describes it as free and open source.

### How do I add Apolo to Claude Code?

Run this command in your terminal: claude mcp add apolo -- npx -y https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb

### What are the best alternatives to Apolo?

The closest alternatives to Apolo are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/apolo
