Skip to content
MCP server

Crabcrop

Signs, explains and purges cache for crabcrop on-demand image URLs from an MCP client

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Crabcrop

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

This small server is a control surface for a crabcrop image server rather than an image generator. It points at your crabcrop base URL, and with the server's signing secret held in the environment it can sign image URLs, explain what a URL does, fetch processed-image metadata and purge cached results.

Crabcrop itself is a Rust image API where the URL is the API: a signed path chains operations such as resize, crop, filters (51 listed) and format conversion in written order, with JPEG, PNG, WebP, GIF, AVIF and JPEG XL as outputs. Optional model-backed features include background removal, face-safe smart crops, object removal, upscaling, face redaction, OCR and C2PA provenance checking. Asking for JSON returns a metadata document instead of image bytes. Responses carry a one-year immutable cache lifetime, which is why a purge tool is useful.

The secret must be at least 16 bytes. The README advises keeping it in the environment, not in tool arguments.

Install

Run in a terminal

claude mcp add crabcrop --env CRABCROP_SECRET='<CRABCROP_SECRET>' -- npx -y @crabcrop/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "crabcrop": {
      "command": "npx",
      "args": [
        "-y",
        "@crabcrop/mcp"
      ],
      "env": {
        "CRABCROP_SECRET": "<CRABCROP_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "crabcrop": {
      "command": "npx",
      "args": [
        "-y",
        "@crabcrop/mcp"
      ],
      "env": {
        "CRABCROP_SECRET": "<CRABCROP_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "crabcrop": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@crabcrop/mcp"
      ],
      "env": {
        "CRABCROP_SECRET": "<CRABCROP_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "crabcrop": {
      "command": "npx",
      "args": [
        "-y",
        "@crabcrop/mcp"
      ],
      "env": {
        "CRABCROP_SECRET": "<CRABCROP_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "crabcrop": {
      "command": "npx",
      "args": [
        "-y",
        "@crabcrop/mcp"
      ],
      "env": {
        "CRABCROP_SECRET": "<CRABCROP_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CRABCROP_BASEBase URL of the crabcrop server the tools act on (for example https://images.example.com).
  • CRABCROP_SECRETThe server's signing secret, used by sign_url and purge_result. Keep it in the environment, not in tool arguments.

Tools this server provides (2)

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

sign_url
Signs a crabcrop image URL.
purge_result
Purges a cached result.

What it does

URL signing
sign_url builds HMAC-signed crabcrop URLs.
URL explanation
Describes what a signed URL will do.
Metadata fetch
Returns processed-image meta such as dimensions and format.
Cache purge
purge_result removes cached renders.
Secret hygiene
The signing secret stays in the environment.

Good for

  • Generate a signed thumbnail URL for a CMS
  • Check what a crabcrop URL does
  • Purge a cached image after replacing its source
  • Inspect render metadata

Pricing

Open source

Free open-source package

Crabcrop FAQ

What does it need to run?

A crabcrop server base URL and its signing secret as environment variables.

What is crabcrop?

A Rust on-demand image API driven by signed URLs.

How does it install?

From npm as @crabcrop/mcp over stdio.

Why purge?

Successful renders carry a one-year immutable cache lifetime.

Is Crabcrop free?

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

How do I add Crabcrop to Claude Code?

Run this command in your terminal: claude mcp add crabcrop --env CRABCROP_SECRET='<CRABCROP_SECRET>' -- npx -y @crabcrop/mcp

What are the best alternatives to Crabcrop?

The closest alternatives to Crabcrop are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers