roundcut-mcp

roundcut-mcp

AI エージェント向けのローカル画像ツールを提供する、MCP サーバーです。 sharp を使って、お使いのマシン上で画像を円形に切り抜き、トリミング、サイズ変更、圧縮、JPG、PNG、WebP、AVIF 形式に変換できます。ネットワーク通信もアカウントもアップロードも不要です。ファイルがディスクの外に出ることはありません。

無料の画像ツールサイト（29 言語対応）である RoundCut が開発しました。

インストール

Node 20 以降が必要です。

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

同じ形式です。stdio サーバーで、コマンドは npx、引数は -y roundcut-mcp です。

Smithery

smithery.ai/servers/araluma/roundcut-mcp を使うと、macOS（Apple Silicon）および Windows（x64）向けの自己完結型バンドルをインストールできます。Linux または Intel Mac では、上記の npx を使用してください。

ツール

ツール	機能	エージェントが呼び出す場面
image_info	形式、寸法、アルファ、EXIF の向きを確認します。	ユーザーが画像の内容を尋ねたとき、または切り抜きやサイズ変更の数値を決める前
circle_crop	丸いプロフィール画像を作成します。中央の正方形に切り抜き、円形の透明マスクを適用します。size、format（デフォルトは png）、jpeg 用の background を指定できます。	ユーザーが Discord、Slack、LinkedIn、WhatsApp、GitHub 用の丸いアバターを求めたとき
crop_image	ピクセル単位の範囲（left、top、width、height）または 1:1、4:5、16:9 などの中央揃えの aspect を指定します。	ユーザーが画像の一部の切り抜きや、固定比率（正方形の投稿、4:5 のポートレート、16:9 のバナー）を求めたとき
resize_image	width、height、または percent を指定してサイズを変更します。アスペクト比を維持し、enlarge: true を指定しない限り拡大しません。Lanczos3 を使用します。	ユーザーが目標のピクセル寸法を指定したとき
compress_image	形式を変えずにファイルサイズを小さくします。jpg／webp／avif では quality を指定でき（jpg には mozjpeg を使用）、png では可逆再圧縮を行います。	同じサイズと形式のまま、ファイルを軽くする必要があるとき（アップロード制限、ページの読み込み高速化など）
convert_image	jpeg、png、webp、avif に変換します。入力には GIF、TIFF、HEIC も指定できます。透過を維持するか、jpeg の場合は background に重ねて平坦化します。	iPhone の HEIC から JPG、PNG から WebP など、別のファイル形式が必要なとき
roundcut_web_tools	このサーバーではローカル実行できないブラウザツールへのリンクを提供します。背景の削除、AI アップスケーリング、一括変換、JPG から PDF への変換が利用できます。	ユーザーがこれらのいずれかを求めたときに、断るのではなく案内します

すべてのツールは input パスを受け取り、デフォルトではそのファイルの隣に出力を書き込みます（photo.jpg は photo-circle.png、photo-resized.jpg、photo.webp になります）。または output に出力できます。結果には、テキストの概要、ファイルへの resource_link、構造化 JSON（output、format、width、height、bytes、inputBytes）、小さな JPEG プレビューが含まれます（プレビューを省略するには preview: false を指定します）。

サーバーに接続したチャットクライアントからの実行例：

~/Pictures/me.jpg を、512 px の WebP 形式の丸いアバターにしてください。

circle_crop を { "input": "~/Pictures/me.jpg", "size": 512, "format": "webp" } で呼び出し、ファイルパス、寸法、バイト数を回答します。

制限事項

• 80 メガピクセルを超える入力は拒否されるため、誤った呼び出しでギガバイト単位のメモリが確保されることはありません。
• 読み込み時に EXIF の向きを適用します。出力は正しい向きになり、EXIF は含まれません。
• jpeg はアルファに対応していません。透過領域は background（デフォルトは白）に重ねて平坦化されます。

開発

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

src/engine.ts は画像処理を担う純粋なレイヤーです（直接テストされています）。src/index.ts はこれを MCP ツールに適合させます。

Smithery のリリースでは、scripts/build-mcpb.sh が mcpb/manifest.json から build/roundcut-mcp-<version>.mcpb をビルドします（上限は 25 MB のため、macOS arm64 と Windows x64 用の sharp バイナリのみが含まれます）。その後、scripts/publish-smithery.sh がビルド済みサーバーから読み込んだツールスキーマとともにアップロードします。

ライセンス

MIT。Copyright Araluma.