What it does
The server gives AI agents local image operations built on sharp, and the files never leave the disk. It includes image_info for reading format, dimensions, alpha and EXIF orientation; circle_crop, which produces a centered square with a circular transparent mask; crop_image, which crops by pixel box or centered aspect ratio; resize_image, which keeps the aspect ratio and does not enlarge unless asked; compress_image; and convert_image, which also accepts GIF, TIFF and HEIC input. A roundcut_web_tools entry links to browser tools that the server does not run locally, such as a background remover, an AI upscaler, batch conversion and JPG to PDF.
An agent would reach for it when a user needs a round avatar for a platform such as Discord, Slack, LinkedIn, WhatsApp or GitHub, a fixed ratio such as a 4:5 portrait or 16:9 banner, a smaller file to meet an upload limit at the same size and format, or a change of file type, for example iPhone HEIC to JPG.
Running it requires Node 20 or newer. It can be added to Claude Code through the MCP command, or registered in Cursor, Windsurf or VS Code as a stdio server that starts through npx. Each tool reads an input path and writes a new file next to it by default, or to a chosen output path. Results include a text summary, a link to the file, structured JSON with dimensions and byte counts, and a small JPEG preview that can be turned off.
Limitations and requirements
Requires Node 20 or newer. Inputs above 80 megapixels are refused. JPEG has no alpha channel, so transparent areas are flattened onto a background colour, white by default.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.Araluma/roundcut-mcp
Local image tools: circle crop, crop, resize, compress, convert JPG/PNG/WebP/AVIF. By RoundCut.
v0.1.2As shown on registry.modelcontextprotocol.io when we last read it