Roundcut Mcp

io.github.AralumaPublished by GitHub account Aralumav0.1.2Updated Oct 24, 2026

Local image tools: circle crop, crop, resize, compress, convert JPG/PNG/WebP/AVIF. By RoundCut.

VerifiedSTDIODesktop onlyFiles & Storage Media & Design

Server details

Identifier: io.github.Araluma/roundcut-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account Araluma for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Araluma%2Froundcut-mcp.svg)](https://sourceweft.com/mcp/io.github.Araluma%2Froundcut-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that lets an assistant inspect, circle-crop, crop, resize, compress and convert images on your own machine.

What you can do: Inspect an image's format, dimensions, alpha and EXIF orientation before choosing parameters
Make round avatars with a circular transparent mask, or crop to a pixel box or fixed aspect ratio
Resize by width, height or percent while keeping the aspect ratio
Compress files in the same format, or convert between JPEG, PNG, WebP and AVIF (GIF, TIFF and HEIC accepted as input)
Return a text summary, a link to the output file, structured JSON and an optional small JPEG preview
When to use it: Useful when you want an assistant to prepare images for uploads, profile pictures, banners or web pages without sending files to a third-party service. Good for quick avatar, ratio and format conversions on a desktop machine.
Requirements: Runs as a local stdio process started with npx, so Node.js 20 or newer is needed. No accounts, API keys or network access are required; a self-contained bundle is offered for macOS Apple Silicon and Windows x64.

Before you install

Tools write new image files next to the input or to a given output path, so point them at the right directory. JPEG output has no transparency and is flattened onto a background colour. Inputs above 80 megapixels are refused, and output files carry no EXIF data.

Installation

In SourceWeft

Open Roundcut Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

Claude Desktop / Claude Code

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.

Smithery

smithery.ai/servers/araluma/roundcut-mcp installs a self-contained bundle for macOS (Apple Silicon) and Windows (x64). On Linux or an Intel Mac, use npx above.

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

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

Smithery release: scripts/build-mcpb.sh builds build/roundcut-mcp-<version>.mcpb from mcpb/manifest.json (25 MB cap, so only the macOS arm64 and Windows x64 sharp binaries go in), then scripts/publish-smithery.sh uploads it with the tool schemas read from the built server.

License

MIT. Copyright Araluma.

Source: README.md at commit 307336a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts