Skip to content
MCP server

Apolo

Optimize, convert and compare images locally from Claude, Cursor or VS Code

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
1.1.1
Listing updated
3 days ago

About Apolo

Apolo is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apolo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apolo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/webcafeina/Apolo/releases/download/v1.1.1/Apolo-1.1.1-macos.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free and open source desktop app; MCP server included

Prices change. Check apolo.webcafeina.com before you buy.

Apolo 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 to Apolo

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media