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

MCPとは何か
MCP(Model Context Protocol)は、AIクライアントに外部ツールを渡すための規格です。サーバーが「このツールが使えます」と一覧を出し、クライアントが会話の流れで必要なものを呼びます。
KaruiのMCPサーバーはstdioのJSON-RPC 2.0で動き、MCP revision 2025-06-18 に対応します。ネットワークアクセスはなく、圧縮はすべてローカルで完結します。
JSON-RPC 2.0
圧縮はすべて同じマシンの中で行われ、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_pdf | PDFを圧縮する | 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段階です。
get_image_infoで対象の幅・高さ・サイズを確認する(任意)compress_imageをpreset: webで実行する- 返ってきた出力パスと圧縮後のサイズを確認する
PDFなら「このPDFを軽くして」でcompress_pdfが呼ばれます。品質はqualityで指定します。画像とPDFで別のアプリを開かなくて済むのが、この構成の実用的な利点です。
ただし、どのツールをどう選ぶかはモデルとクライアントの実装次第です。モデル名や画面の文言は変わります。設定手順は、常にクライアントの公式ドキュメントを優先してください。
# 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).
会話から呼べる圧縮、1日20ファイルまで無料です
Karuiを無料で試すつまずきポイントと他のMCPサーバーとの違い
パスは絶対パスで書く
~や相対パスは、動かない場面があります。whichとpwdで確認した絶対パスを使ってください。空白を含むパスは、JSONの文字列なのでそのまま書けます。
stdio専用で、ポートは開かない
HTTPのURLやポートを設定する項目はありません。commandにバイナリを指定します。サーバーはクライアントのstdioに接続し、クライアントが終了すればプロセスも終わります。
設定変更後は再起動する
保存しただけでは反映されません。完全終了してから起動します。反映されないときはJSONの構文を疑ってください。末尾カンマ、全角の引用符、mcpServersの階層。この3つで大抵つまずきます。
権限とファイルの存在を確認する
デスクトップや書類フォルダのファイルを扱うと、macOSのファイルアクセス許可を求められることがあります。許可しないと、サーバーはファイルを開けません。存在しないパスを渡すと、ツールはエラーを返します。エラーは結果としてモデルに渡るので、会話の中で内容を確認できます。
他のMCPサーバーとの違い
Karui MCPは画像生成でも、クラウド連携でもありません。できるのはローカルファイルの圧縮と情報取得だけです。ネットワークアクセスがなく、APIキーも不要。同期処理で、常駐しません。ツールが3つに絞られているぶん、設定と挙動が読みやすい。
「何でもできるサーバー」ではありません。画像とPDFを軽くする、という1点に絞った道具として使ってください。
会話から、ローカルで、画像を軽くする
クレジットカード不要・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のデコードが無効です。
だいち