Skip to content
MCP server

Ruah

On-device image tools for agents: cutouts, compress, resize, crop, upscale, EXIF removal

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About Ruah

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

Files stay on your computer. The server runs AI models and encoders locally, writing each result as a new file beside the original and returning its path with a small preview; existing files are never overwritten. Only model weights are downloaded, once, from Ruah's mirror, each checked against a pinned SHA-256 hash and cached in ~/.cache/ruah/models.

Background removal uses BiRefNet, with a lite 98 MB model fetched first and a larger one used only if no subject is found; upscaling uses Swin2SR at 2x or 4x. Compression, resizing, cropping and metadata removal need no download. Metadata removal strips EXIF (including GPS), XMP, IPTC and comments, and JPEG and PNG are cleaned without re-encoding.

It needs Node.js 20 or newer. Apple Silicon Macs are tested and use the GPU for upscaling; Linux and Windows use the CPU, and Intel Macs are not supported. HEIC input works only on macOS. The package is MIT licensed and is the engine behind the ruah.tools web app.

Install

Run in a terminal

claude mcp add ruah-mcp -- npx -y ruah-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ruah-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ruah-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ruah-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ruah-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ruah-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ruah-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ruah-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ruah-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ruah-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ruah-mcp"
      ]
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

remove_background
Cuts the main subject out of a photo and saves a transparent PNG.
compress
Makes an image smaller or converts it to WebP, AVIF, JPEG or PNG.
resize
Changes pixel dimensions while keeping proportions.
crop
Crops to an aspect ratio or region, rotates by quarter turns and flips.
upscale
Enlarges an image 2x or 4x with AI super-resolution.
strip_metadata
Removes EXIF, XMP, IPTC, comments and embedded thumbnails.

What it does

Background removal
Cuts out the main subject and saves a transparent PNG.
Compress and convert
Shrinks images or converts to WebP, AVIF, JPEG or PNG.
Resize and crop
Resize by longest side or percent, or crop to a ratio or region without resampling.
AI upscaling
Enlarge 2x or 4x while keeping transparency.
Metadata stripping
Remove EXIF, XMP, IPTC, comments and embedded thumbnails.
Non-destructive output
Writes new files and never overwrites the original.

Good for

  • Prepare product photos with transparent backgrounds
  • Convert screenshots to WebP in a batch
  • Strip GPS location from photos before sharing
  • Upscale a small image by 2x or 4x
  • Shrink image weight before a site release

Pricing

Open source

MIT licensed; the ruah.tools web app is free and unlimited

Prices change. Check ruah.tools before you buy.

Ruah FAQ

Do my images leave my computer?

No. Processing runs locally; only model weights are downloaded, once.

Which Node.js version is needed?

Node.js 20 or newer.

Does it work on Intel Macs?

No. The ONNX runtime it uses ships no build for them.

Can it read iPhone HEIC photos?

Only on macOS, because HEVC decoding is available only there.

What licence applies?

ruah-mcp is MIT licensed; the downloaded models keep their own licences (BiRefNet MIT, Swin2SR Apache-2.0).

Is Ruah free?

Yes. Ruah is open source, so you can use and self-host it for free.

How do I add Ruah to Claude Code?

Run this command in your terminal: claude mcp add ruah-mcp -- npx -y ruah-mcp

What are the best alternatives to Ruah?

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

Alternatives to Ruah

  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. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. ChartAnt

    MCP server

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

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. 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