English Français العربية

io.github.Araluma/roundcut-mcp

السجل الرسمي الوسائط والتصميم

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package roundcut-mcp
Claude Code 
claude mcp add roundcut-mcp -- npx -y roundcut-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "roundcut-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "roundcut-mcp@0.1.2"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. roundcut-mcp
  2. Install
  3. Tools
  4. Limits
  5. Develop
  6. License

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

ToolWhat it doesAn agent calls it when
image_infoFormat, dimensions, alpha, EXIF orientation.the user asks what an image is, or before picking crop/resize numbers
circle_cropRound 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_imagePixel 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_imageBy width, height or percent. Keeps the aspect ratio, never enlarges unless enlarge: true. Lanczos3.the user gives target pixel dimensions
compress_imageSmaller 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_imageTo 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_toolsLinks 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.

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.

الأسئلة الشائعة

ما هو io.github.Araluma/roundcut-mcp؟

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

كيف أثبّت io.github.Araluma/roundcut-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add roundcut-mcp -- npx -y roundcut-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Araluma/roundcut-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.Araluma/roundcut-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Araluma/roundcut-mcp؟

ينشره Araluma. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.