Compressfile.pro

mcp-compressfile

compressfile.pro 向けの公式 Model Context Protocol (MCP) サーバーです。
MCP 対応の AI エージェント（Claude、Cursor など）に、画像の一括圧縮、変換、サイズ変更、透かしの追加、分析を、すべてローカルマシン上で行う機能を提供します。

---

✨ 機能

• 画像最適化ワークフロー全体を網羅する 15 個の AI ツール
• 4 種類の最新フォーマット — AVIF、WebP、JPEG、PNG
• フォーマットごとに調整されたパラメーターによる非可逆・可逆圧縮
• glob パターン（/data/**/*.png）による一括処理
• 透過処理 — すべてのフォーマットでアルファ合成を適切に処理
• EXIF 自動回転 — 変換前に適用
• 平均ハッシュを使用した知覚的重複検出
• ドライランによる見積もり — ファイルを書き込む前に削減量を予測
• プライバシー優先 — 画像がマシンの外部に送信されることはありません

---

🌐 インストール不要？Web 版をご利用ください

AI との連携が不要な場合は、compressfile.pro で、アップロード、アカウント登録、インストールなしに、ブラウザー上で同じ圧縮と変換を利用できます。

	compressfile.pro	mcp-compressfile
ブラウザーで動作	✅	—
インストール不要	✅	—
AI エージェント連携	—	✅
glob パターンによる一括処理	—	✅
ローカルファイルを処理	—	✅
画像がマシンの外部に送信される	❌ 送信されません	❌ 送信されません

---

🛠 インストール

オプション A — Python（推奨）

pip install mcp[server] Pillow pillow-avif-plugin imagehash

このリポジトリをクローンし、Claude Desktop で server.py を指定してください（設定を参照）。

オプション B — Docker

git clone https://github.com/yourname/mcp-compressfile
cd mcp-compressfile
docker build -t mcp-compressfile .

---

⚙️ 設定

Claude Desktop を開き、Settings → Developer → Edit Config に移動して、以下のいずれかの設定ブロックを追加します。

Python

{
  "mcpServers": {
    "mcp-compressfile": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Docker

{
  "mcpServers": {
    "mcp-compressfile": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/your/images/folder:/data",
        "mcp-compressfile"
      ]
    }
  }
}

Windows ユーザー向け： パスにはスラッシュを使用してください（C:/Users/You/Pictures）。
Docker を使用する場合は、ツールに /data/... のパスを渡してください。これはコンテナー内のマウントポイントです。

設定を編集した後、Claude Desktop を再起動してください。チャット入力欄に 🔨 ハンマーアイコンが表示されれば、ツールが読み込まれています。

---

🤖 Claude での使い方

設定後は、自然な英語で実行したい内容を説明するだけです。Claude が適切なツールを選び、自動的に連携して実行し、概要を報告します。

1. プロンプトを入力 — Claude がファイルを特定し、処理を計画します

2. Claude が一括処理を実行し、詳細な概要を返します

この例では、1 つのプロンプトで JPEG 7 枚を品質 80 の WebP に変換し、
合計サイズを 4.4 MB から 657 KB に削減しました。85% の削減です。

---

🧰 ツール

ファイルとフォルダー

ツール	説明
list_files	ディレクトリ内の対応画像をすべて、ファイルサイズとともに一覧表示します
find_large_images	指定した KB のしきい値を超える画像を検索します。圧縮作業の開始時に最適です
compare_folders	入力元と出力先を比較し、処理済みのファイルと未処理のファイルを確認します
undo_last_batch	出力ディレクトリを削除して、別の設定で再試行します（confirm=True が必要です）

分析とメタデータ

ツール	説明
get_image_info	1 つのファイルの完全なメタデータを取得します：寸法、DPI、モード、およびすべての EXIF フィールド
strip_metadata	公開前に、プライバシー保護のため EXIF/IPTC/XMP データをすべて削除します
find_duplicates	知覚的ハッシュを使用して、類似した画像をグループ化します

変換

ツール	説明
bulk_compress	圧縮・変換・任意のサイズ変更を行います。EXIF の向きは自動修正されます
bulk_resize	フォーマットとアスペクト比を維持して、サイズのみを変更します
bulk_crop	一括処理で指定したピクセル領域を切り抜きます。範囲外のボックスが指定されたファイルはスキップします
bulk_rotate	指定した角度で回転し、EXIF の向きを自動修正することもできます
bulk_watermark	位置、不透明度、フォントサイズを設定して、画像にテキストを重ねます

レポートとエージェント向けヘルパー

ツール	説明
compression_report	ジョブ完了後の統計情報を集計します。削減した容量の合計（MB）、形式ごとの内訳、ファイルごとのログを確認できます
preview_settings	1 枚の画像を複数の品質レベルで圧縮し、最適なバランスを見つけます
suggest_format	画像を分析し、理由とともに最適な出力形式を提案します
estimate_savings	バッチ処理の事前予測を行います。ディスクにはファイルを書き込みません

---

💬 プロンプトの例

List all images in /data and tell me which ones are larger than 1 MB.

Suggest the best format for all files in /data/photos.

Estimate how much space I'd save converting /data/*.jpg to AVIF at quality 80.

Compress everything in /data/photos to WebP at quality 75, max 1920px wide,
and save to /data/output.

Find duplicate images in /data/vacation.

Add a "© compressfile.pro" watermark to all PNGs in /data, bottom-right, 50% opacity.

Show me a compression preview for /data/hero.jpg at quality 60, 75, 85, and 95.

Generate a full compression report comparing /data/originals and /data/output.

---

📦 対応形式

形式	非可逆圧縮	可逆圧縮	透過	備考
AVIF	✅	—	✅	写真の圧縮率が最も高い
WebP	✅	✅	✅	最も汎用性の高い形式
JPEG	✅	—	—	アルファチャンネルは白い背景に合成されます
PNG	—	✅	✅	グラフィックやベタ塗りのイラストに最適

対応する入力形式： .png .jpg .jpeg .webp .tiff .bmp .avif

---

🔒 プライバシー

すべての処理は Pillow を使用してローカルで実行されます。画像データがサーバーにアップロードされることはありません。
この MCP サーバーは compressfile.pro と連携するローカルツールです。compressfile.pro では、サーバーにアップロードすることなく、ブラウザー内で同じ機能を利用できます。

---

📋 要件

mcp[server]
Pillow
pillow-avif-plugin
imagehash

Python 3.9 以降。

---

📄 ライセンス

MIT