mochify-cli: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project

mochify-cli is a Rust CLI tool and MCP server that wraps the mochify.app image processing API (POST https://api.mochify.app/v1/squish). It uploads local images via multipart form and saves the processed result.

Commands

# Build
cargo build

# Build release
cargo build --release

# Check (fast, no binary output)
cargo check

# Run (process an image)
cargo run -- photo.jpg -t webp -w 800

# Ultra HDR gain map (jpg output only)
cargo run -- photo.jpg -t jpg --hdr generate

# Quality controls
cargo run -- photo.jpg -t webp -q 70
cargo run -- photo.jpg -t avif --smart-compress --optimize-for-web
cargo run -- scan.png -t webp --lossless

# Process a PDF (auto-detected by .pdf extension)
cargo run -- document.pdf --op rasterize -t png --dpi 150
cargo run -- report.pdf --op optimize -q 75 --dpi 150
cargo run -- document.pdf -p "split into pngs"   # NLP prompt path

# Build a PDF from images (--op create; images in, PDF out)
cargo run -- page-*.jpg --op create --page a4

# Run MCP server on stdio
cargo run -- serve

# Run tests
cargo test

# Run a single test
cargo test <test_name>

# Lint
cargo clippy

# Format
cargo fmt

Architecture

src/
  main.rs        Async entry point. Parses CLI args (clap), dispatches:
                   - `serve` subcommand → starts MCP server on stdio
                   - no subcommand     → calls process_files(), which routes
                     `--op create` to create_pdf() (images in, PDF out),
                     `.pdf` inputs to process_pdfs(), and images to the squish flow
  cli.rs         Clap `Args` struct and `Commands` enum (Serve subcommand)
  api.rs         `MochifyClient` + `ProcessParams` / `PdfParams` — all HTTP logic.
                   `squish()` posts an image to /v1/squish; `pdf()` posts a PDF to
                   /v1/pdf; `pdf_create()` posts images to /v1/pdf?op=create as
                   multipart. `PdfParams::for_op()` validates the op and maps the
                   generic dpi/max-width inputs onto that op's query parameters.
                   Response bytes written to disk.
  mcp/
    mod.rs       Re-exports MochifyMcp
    tools.rs     `MochifyMcp` struct implements ServerHandler via rmcp macros.
                   Exposes `squish` (mirrors ProcessParams), `pdf` (the PDF-in ops)
                   and `pdf_create` (images → PDF).