# Crabcrop

> Crabcrop is an open-source MCP server for design and media. Signs, explains and purges cache for crabcrop on-demand image URLs from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/dayvson/crabcrop
- **MCP Registry name:** io.github.crabcrop/crabcrop
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `sign_url`: Signs a crabcrop image URL.
- `purge_result`: Purges a cached result.

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/crabcrop
