無料で圧縮 料金 比較 ブログ 作者 English

技術ブログ / MCP

Claudeに画像圧縮をさせる:Karui MCPサーバーの設定と実例

画像を軽くするためだけにアプリを開く。その一手間を、会話に置き換えます。Claude DesktopにKaruiのMCPサーバーを登録すると、「デスクトップの写真をWeb用に圧縮して」で圧縮が走ります。設定はJSONに1エントリだけです。

チャット画面を開いたノートPCのキーボードに手を置いている写真。画面には写真のサムネイルが1枚見える

MCPとは何か

MCP(Model Context Protocol)は、AIクライアントに外部ツールを渡すための規格です。サーバーが「このツールが使えます」と一覧を出し、クライアントが会話の流れで必要なものを呼びます。

KaruiのMCPサーバーはstdioのJSON-RPC 2.0で動き、MCP revision 2025-06-18 に対応します。ネットワークアクセスはなく、圧縮はすべてローカルで完結します。

Karui MCPの構成です。ポートも開きません。

なぜ画像圧縮をMCPにするのか

理由は3つあります。

1つ目は、アップロードが不要なこと。Karui MCPはローカルのファイルパスを受け取り、同じマシンで圧縮します。画像データを外部のAPIに送りません。

2つ目は、結果が再現されること。preset: web は1600px・品質75です。CLIのプリセットと同じ設定なので、会話のたびに数値がぶれません。

3つ目は、無料枠とライセンスをGUIと共有すること。1日20ファイルの枠も、$29のProライセンスも同じです。MCPのために別の契約をする必要はありません。

接点 操作 向く場面
GUIドラッグ&ドロッププレビューしながら数枚を処理する
CLIコマンド大量・定期処理をスクリプトにする
MCP会話手を動かさず、その場の1枚を軽くする

3つとも同じエンジンと同じクォータを使います。MCPは「アプリを開かずに済む入口」であって、別の製品ではありません。

Karui MCPのセットアップ

バイナリの場所を確認する

install.shはkaruiとkarui-mcpの両方を入れます。まずは場所を確認してください。

curl -fsSL https://karui.app/install.sh | sh
which karui-mcp

典型的には/Users/yourname/.local/bin/karui-mcpにあります。ソースからビルドする場合は cargo build --release -p karui-mcp で、karui-app/src-tauri/target/release/karui-mcp にできます。

設定JSONを書く

macOSの設定ファイルは~/Library/Application Support/Claude/claude_desktop_config.jsonです。既存のmcpServersにkaruiを足します。

{
  "mcpServers": {
    "karui": {
      "command": "/Users/yourname/.local/bin/karui-mcp"
    }
  }
}

commandは必ず絶対パスにします。JSONの中では~が展開されません。which karui-mcpの出力をそのまま貼ってください。

すでに他のサーバーが入っている場合は、mcpServersの中にカンマで追加します。JSONにコメントや末尾カンマは書けません。エディタの構文チェックを通してから保存します。

クライアントを再起動する

設定は起動時に読まれます。Claude Desktopを完全に終了して、開き直してください。macOSならメニューのQuitです。ウィンドウを閉じるだけでは再読み込みされません。起動後、ツール一覧にkaruiが出ていれば成功です。

使える3つのツール

サーバーが公開するツールは3つだけです。

ツール できること 主な引数
compress_image画像1枚を圧縮するinput_path, output_path?, format?, quality?, max_edge?, preset?
compress_pdfPDFを圧縮するinput_path, output_path?, quality?
get_image_info幅・高さ・形式・サイズを返すpath

presetはhi、web、lightの3つです。formatはjpeg、png、webp。qualityとmax_edgeを個別に指定すれば、プリセットは不要です。

ツールにはJSONで引数が渡されます。たとえば次のような形です。

{"input_path":"/Users/me/Desktop/photo.jpg","preset":"web","output_path":"/Users/me/Desktop/out/photo.jpg"}

get_image_infoは圧縮前の確認に使います。残りのクォータは、ターミナルでkarui statusを叩けば分かります。

会話例:デスクトップの写真をWeb用に圧縮する

「デスクトップの写真をWeb用に圧縮して」と伝えます。クライアントはツール一覧からcompress_imageを選び、preset: webとデスクトップのパスを組み立てて呼びます。モデルが自動で判断するので、コマンド名を覚える必要はありません。

処理の流れは3段階です。

  1. get_image_infoで対象の幅・高さ・サイズを確認する(任意)
  2. compress_imageをpreset: webで実行する
  3. 返ってきた出力パスと圧縮後のサイズを確認する

PDFなら「このPDFを軽くして」でcompress_pdfが呼ばれます。品質はqualityで指定します。画像とPDFで別のアプリを開かなくて済むのが、この構成の実用的な利点です。

ただし、どのツールをどう選ぶかはモデルとクライアントの実装次第です。モデル名や画面の文言は変わります。設定手順は、常にクライアントの公式ドキュメントを優先してください。

karui-mcp の実際の応答
# get_image_info
/tmp/karui-demo/jpg/photo-01.jpg: 3504x2336 jpeg 3.46 MB

# compress_image(preset: web)
Compressed /tmp/karui-demo/jpg/photo-01.jpg -> /tmp/karui-demo/jpg/mcp-out/photo-01.jpg (3.46 MB -> 249.4 KB, 93.0% smaller, 1600x1067).
stdioで karui-mcp を直接呼び出したときの応答テキストです。Claude Desktopの画面ではありません。出力先のフォルダがないとエラーになるので、先に作っておきます。

会話から呼べる圧縮、1日20ファイルまで無料です

Karuiを無料で試す

つまずきポイントと他のMCPサーバーとの違い

パスは絶対パスで書く

~や相対パスは、動かない場面があります。whichとpwdで確認した絶対パスを使ってください。空白を含むパスは、JSONの文字列なのでそのまま書けます。

stdio専用で、ポートは開かない

HTTPのURLやポートを設定する項目はありません。commandにバイナリを指定します。サーバーはクライアントのstdioに接続し、クライアントが終了すればプロセスも終わります。

設定変更後は再起動する

保存しただけでは反映されません。完全終了してから起動します。反映されないときはJSONの構文を疑ってください。末尾カンマ、全角の引用符、mcpServersの階層。この3つで大抵つまずきます。

権限とファイルの存在を確認する

デスクトップや書類フォルダのファイルを扱うと、macOSのファイルアクセス許可を求められることがあります。許可しないと、サーバーはファイルを開けません。存在しないパスを渡すと、ツールはエラーを返します。エラーは結果としてモデルに渡るので、会話の中で内容を確認できます。

他のMCPサーバーとの違い

Karui MCPは画像生成でも、クラウド連携でもありません。できるのはローカルファイルの圧縮と情報取得だけです。ネットワークアクセスがなく、APIキーも不要。同期処理で、常駐しません。ツールが3つに絞られているぶん、設定と挙動が読みやすい。

「何でもできるサーバー」ではありません。画像とPDFを軽くする、という1点に絞った道具として使ってください。

Try Karui Free

会話から、ローカルで、画像を軽くする

クレジットカード不要・1日20ファイルまで無料。気に入ったら $29 買い切り(永久ライセンス + 1年アップデート)。

Windows 10+ / macOS 12.0+ / 100% ローカル処理

よくある質問

MCPサーバーは常駐しますか?

常駐しません。呼ばれたときに起動し、処理が終わると終了します。バックグラウンドで待ち受けるプロセスではないので、使わないときに常駐してメモリを消費することはありません。

Claude Desktop以外でも使えますか?

MCPに対応したクライアントなら使えます。stdioのJSON-RPC 2.0で通信し、MCP revision 2025-06-18に対応します。設定ファイルの場所と書き方はクライアントごとに異なります。

画像は外部に送信されますか?

Karui MCPはネットワークアクセスを持たず、画像はローカルで処理されます。ツールに渡るのはファイルパスと引数です。会話そのものの送信はClaude Desktop側の仕様に従います。

無料枠はGUIと別ですか?

同じです。GUI・CLI・MCPで1日20ファイルを共有します。$29の買い切りProライセンスも共通で、MCP用の追加ライセンスはありません。

HEICやPDFも圧縮できますか?

macOSではHEIC/HEIFを入力できます。PDFはcompress_pdfで圧縮します。Windows/LinuxのビルドはHEIC/HEIF/AVIFのデコードが無効です。