Skip to main content
Glama
Sign In
roundcut-mcp

roundcut-mcp

by Araluma
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

roundcut-mcp

Local image tools for AI agents, as an MCP server. Circle crop, crop, resize, compress and convert JPG, PNG, WebP and AVIF on your own machine with sharp. No network calls, no accounts, no upload: the files never leave the disk.

Made by RoundCut, the free image tools site (29 languages).

Install

Node 20 or newer.

npx roundcut-mcp

Claude Desktop / Claude Code

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

Claude Code: claude mcp add roundcut -- npx -y roundcut-mcp

Cursor, Windsurf, VS Code

Same shape: a stdio server, command npx, args -y roundcut-mcp.

Related MCP server: obrobka-mcp

Tools

Tool

What it does

An agent calls it when

image_info

Format, dimensions, alpha, EXIF orientation.

the user asks what an image is, or before picking crop/resize numbers

circle_crop

Round profile picture: centered square plus a circular transparent mask. size, format (png default), background for jpeg.

the user wants a round avatar for Discord, Slack, LinkedIn, WhatsApp or GitHub

crop_image

Pixel box (left, top, width, height) or a centered aspect such as 1:1, 4:5, 16:9.

the user wants part of an image or a fixed ratio (square post, 4:5 portrait, 16:9 banner)

resize_image

By width, height or percent. Keeps the aspect ratio, never enlarges unless enlarge: true. Lanczos3.

the user gives target pixel dimensions

compress_image

Smaller file, same format. quality for jpg/webp/avif (mozjpeg for jpg), lossless recompression for png.

the file must be lighter (upload limit, faster page) at the same size and format

convert_image

To jpeg, png, webp or avif. Input may also be GIF, TIFF or HEIC. Transparency kept, or flattened onto background for jpeg.

the user needs another file type, e.g. iPhone HEIC to JPG, PNG to WebP

roundcut_web_tools

Links to the browser tools this server does not run locally: background remover, AI upscaler, batch convert, JPG to PDF.

the user asks for one of those, instead of declining

Every tool takes an input path and writes next to it by default (photo.jpg becomes photo-circle.png, photo-resized.jpg, photo.webp), or to output. Results carry a text summary, a resource_link to the file, structured JSON (output, format, width, height, bytes, inputBytes) and a small JPEG preview (preview: false to skip it).

Example, from a chat client with the server attached:

Make ~/Pictures/me.jpg a 512 px round avatar as WebP.

calls circle_crop with { "input": "~/Pictures/me.jpg", "size": 512, "format": "webp" } and answers with the file path, the dimensions and the byte count.

Limits

  • Inputs above 80 megapixels are refused, so a stray call cannot allocate gigabytes.

  • EXIF orientation is applied on read; the output is upright and carries no EXIF.

  • jpeg has no alpha: transparent areas are flattened onto background (white by default).

Develop

npm install
npm test        # builds, then node --test

src/engine.ts is the pure image layer (tested directly). src/index.ts adapts it to MCP tools.

License

MIT. Copyright Araluma.

Available Tools

7 tools
circle_cropCircle cropA

Make a round profile picture: center-square crop plus a circular transparent mask. png (default), webp and avif keep the transparent corners; jpeg flattens them onto a background color.

Inputs: input (required), size, format, output, +3 more.

compress_imageCompress imageA

Smaller file, same format. jpg/webp/avif re-encode at quality (default 80, mozjpeg for jpg); png is recompressed losslessly.

Inputs: input (required), output, preview, quality.

convert_imageConvert imageA

Convert between jpeg, png, webp and avif (the input may also be GIF, TIFF or HEIC). Transparency is kept except for jpeg, which is flattened onto background.

Inputs: input (required), format (required), output, preview, +2 more.

crop_imageCrop imageB

Crop to a pixel box (left, top, width, height) or to a centered aspect ratio such as 1:1, 4:5 or 16:9.

Inputs: input (required), top, left, width, +7 more.

image_infoImage infoA
Read-only

Read format, dimensions, alpha and EXIF orientation of an image file.

Inputs: input (required).

resize_imageResize imageA

Resize by width, height or percent. Keeps the aspect ratio (fit=inside) and never enlarges unless enlarge=true. Lanczos3 resampling.

Inputs: input (required), fit, width, format, +7 more.

roundcut_web_toolsRoundCut web toolsA
Read-only

Links to the RoundCut browser tools for what this server does not do locally: AI background removal, AI upscaling, batch conversion and image-to-PDF. Free, 29 languages.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 7 tools

    Disambiguation4/5

    Each tool targets a distinct image operation, but compress_image and convert_image have some conceptual overlap since both involve re-encoding. The descriptions clarify that one keeps the format while the other changes it, so the ambiguity is mostly resolved. circle_crop is also distinct from crop_image because it adds a circular mask.

    Naming Consistency4/5

    Most tools follow a predictable verb_image pattern: compress_image, crop_image, resize_image, and convert_image. However, image_info is a noun phrase and roundcut_web_tools is a branded noun, which breaks the otherwise consistent convention.

    Tool Count5/5

    Seven tools is a well-scoped count for a local image-processing server: one inspection tool, five common transform tools, and one pointer to web-only features. No tool feels redundant, and the set is neither too thin nor bloated.

    Completeness4/5

    The tool surface covers core image workflows: inspect, compress, crop, circle-crop, resize, and convert. Minor gaps like rotate or flip are not covered, but the server explicitly points to web tools for advanced operations, so common local tasks do not hit dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers