MCP.Market

Roundcut MCP server

by Araluma·io.github.Araluma/roundcut-mcp·v0.1.2
No reviews yet

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

A89/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A89/100

full report

Adoption
Growing

0 stars226 downloads/wk

Reviews

Write one

Nobody has reviewed Roundcut yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Roundcut tools (7)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • circle_crop

    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. Use when the user wants a round avatar or profile photo (Discord, Slack, LinkedIn, WhatsApp, GitHub) from a local image.

  • compress_image

    Smaller file, same format. jpg/webp/avif re-encode at `quality` (default 80, mozjpeg for jpg); png is recompressed losslessly. Use when the user needs a lighter file (an upload size limit, a faster web page) without changing format or dimensions.

  • convert_image

    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`. Use when the user needs another file type, e.g. an iPhone HEIC to JPG, PNG to WebP for the web, or any image to AVIF.

  • crop_image

    Crop to a pixel box (left, top, width, height) or to a centered aspect ratio such as 1:1, 4:5 or 16:9. Use when the user wants part of an image or a fixed ratio (square post, 4:5 portrait, 16:9 banner); for a round avatar use circle_crop.

  • image_info

    Read format, dimensions, alpha and EXIF orientation of a local image file. Call it first when the user asks what an image is, or before picking crop or resize numbers.

  • resize_image

    Resize by width, height or percent. Keeps the aspect ratio (fit=inside) and never enlarges unless enlarge=true. Lanczos3 resampling. Use when the user gives target pixel dimensions or wants an image physically smaller or larger; for a lighter file at the same size use compress_image.

  • roundcut_web_tools

    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. Call it when the user asks for one of those, so you can point to a working tool instead of declining.

Public scan report

scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it

no findings
  • Code scan8 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 19 days ago15/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 89/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Roundcut compares

Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
89/100
higher than 80% of 1,337 Media servers
Tools
7
the typical Media server has 7
Tools that change things
0%
typical: 4%. Fewer write tools means less an agent can break
Downloads a week
226
more than 77% of 365 Media servers with a package

What its tools let an agent do: 7 read

Install Roundcut in Claude Code, Cursor or VS Code

Runs npx -y roundcut-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add roundcut-mcp -- npx -y roundcut-mcp
Add to Cursor

What the publisher says

From the Roundcut repository's README, as published. We do not edit it. Read it on GitHub

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.

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

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.

Smithery release: scripts/build-mcpb.sh builds build/roundcut-mcp-.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.

Nothing above is checked by us. What we check is on the safety report.

Roundcut: common questions

Is Roundcut MCP server safe?
Yes, by our scan: it is graded A (89/100). Read the Roundcut safety report
How do I install Roundcut?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Roundcut need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Roundcut maintained?
The last commit was 50 days ago (2026-09-14). The latest release is v0.1.2.
What can I use instead of Roundcut?
Servers from other publishers that do the same job: FFmpeg MCP server, SVG to Video MCP server and Remove AI Watermarks MCP server.
How does Roundcut compare with other Media MCP servers?
safety score 89/100 (higher than 80% of 1,337 Media servers); tools 7 (the typical Media server has 7); tools that change things 0% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Roundcut

Same job from other publishers: the closest match first, then the best rated.

  • FFmpeg
    Trim, convert, resize, compress, and remix audio and video.
    A
  • SVG to Video
    Convert animated SVG (CSS/SMIL) to video (MP4/WebM) or image (GIF/aPNG) with in-band delivery.
    A
  • Remove AI Watermarks
    Identify and remove AI watermarks and provenance metadata from your own images and video.
    A
  • Audio
    Edit, analyze and convert audio: loudness, spec checks, denoise, EQ, cuts, BPM, key. No ffmpeg.
    A
  • Transloadit Media Processing
    Process video, audio, images and documents with Transloadit Robots. Connect by URL with OAuth.
    A