mochify-cli

A command-line tool and MCP server for mochify.xyz — a fast, privacy-first image compression and conversion API powered by a native C++ engine.

Compress and convert images to modern formats (AVIF, JXL, WebP, Jpegli) from your terminal, or give AI assistants like Claude direct access to image processing via the Model Context Protocol.

Installation

cargo install --path .

Or build manually:

cargo build --release
# binary at ./target/release/mochify-cli

CLI Usage

mochify-cli [OPTIONS] <FILES>...

Options

Flag	Description
-t, --type <FORMAT>	Output format: jpg, png, webp, avif, jxl
-w, --width <N>	Target width in pixels
-H, --height <N>	Target height in pixels
--crop	Crop to exact dimensions
-r, --rotation <DEG>	Rotation: 0, 90, 180, 270
-o, --output <DIR>	Output directory (default: same as input)
-k, --api-key <KEY>	API key (or set MOCHIFY_API_KEY env var)

Examples

# Convert a JPEG to AVIF
mochify-cli photo.jpg -t avif

# Resize and convert to WebP
mochify-cli photo.jpg -t webp -w 800

# Batch convert a folder to AVIF at 1200px wide
mochify-cli ./images/*.jpg -t avif -w 1200 -o ./compressed

# With an API key
MOCHIFY_API_KEY=your-key mochify-cli photo.jpg -t jxl

Free usage is 25 images per day without an API key. Visit mochify.xyz for more.

MCP Server (Claude Desktop)

mochify-cli can run as an MCP server, letting Claude process images on your behalf directly from conversation.

Setup

Add the following to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mochify": {
      "command": "/path/to/mochify-cli",
      "args": ["serve"],
      "env": {
        "MOCHIFY_API_KEY": "your-key-here"
      }
    }
  }
}

Restart Claude Desktop. The mochify server will appear in your connections.

Usage

Just describe what you want in natural language, with the full path to your image:

"Convert /Users/me/Desktop/photo.jpg to AVIF at 1000px wide"

"Compress all the JPEGs in /Users/me/projects/blog/images/ to WebP and save them to /Users/me/projects/blog/compressed/"

Claude will call the squish tool automatically.

API

Powered by the mochify.xyz API at https://api.mochify.xyz/v1/squish.

• Images are processed in-memory and never stored on disk
• Supports JPEG (Jpegli), AVIF, JXL, WebP, and PNG output
• Up to 25MB per image

Visit mochify.xyz for the web interface.