Crabcrop
Signs, explains and purges cache for crabcrop on-demand image URLs from an MCP client
- 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/mcpAdd 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.


