Compressfile.pro

mcp-compressfile

compressfile.pro 的官方 Model Context Protocol (MCP) 服务。
让任何兼容 MCP 的 AI Agent（Claude、Cursor 等）都能在你的本地计算机上批量压缩、转换、调整尺寸、添加水印和分析图像。

---

✨ 功能

• 15 个 AI 工具，涵盖完整的图像优化工作流
• 4 种现代格式 — AVIF、WebP、JPEG、PNG
• 有损和无损压缩，针对每种格式调整参数
• 通过 glob 模式进行批量操作（/data/**/*.png）
• 透明度处理 — 为每种格式正确合成 Alpha 通道
• EXIF 自动旋转，在进行任何转换前应用
• 使用平均哈希进行感知重复项检测
• 试运行估算 — 写入任何文件前预测可节省的空间
• 隐私优先 — 你的图像绝不会离开本地计算机

---

🌐 不想安装？使用网页版

不需要 AI 集成？compressfile.pro 可直接在浏览器中进行同样的压缩和转换 — 无需上传、无需账号、无需安装。

	compressfile.pro	mcp-compressfile
可在浏览器中使用	✅	—
无需安装	✅	—
AI Agent 集成	—	✅
通过 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 执行批处理并返回完整摘要

在此示例中，只需一条提示词，就将 7 张 JPEG 转换为质量为 80 的 WebP，
总大小从 4.4 MB 降至 657 KB — 减少了 85%。

---

🧰 工具

文件与文件夹

工具	描述
list_files	列出目录中所有受支持的图像及其文件大小
find_large_images	查找大于指定 KB 阈值的图像 — 是压缩任务的理想起点
compare_folders	比较源文件夹与输出文件夹，查看已处理和待处理的内容
undo_last_batch	删除输出目录，以便使用不同设置重试（必须设置 confirm=True）

分析与元数据

工具	描述
get_image_info	单个文件的完整元数据：尺寸、DPI、模式和所有 EXIF 字段
strip_metadata	发布前移除所有 EXIF/IPTC/XMP 数据，以保护隐私
find_duplicates	使用感知哈希对近似相同的图像进行分组

转换

工具	描述
bulk_compress	压缩 + 转换 + 可选调整尺寸；自动校正 EXIF 方向
bulk_resize	仅调整尺寸，同时保留格式和纵横比
bulk_crop	从一批图像中裁剪固定像素区域；对于裁剪框超出边界的文件则跳过
bulk_rotate	按角度旋转和/或自动校正 EXIF 方向
bulk_watermark	在图像上添加文字水印，可配置位置、不透明度和字体大小

报告与 Agent 辅助工具

工具	描述
compression_report	作业完成后的汇总统计：释放的总 MB 数、按格式细分的数据以及逐文件日志
preview_settings	以多个质量等级压缩一张图片，找到最佳权衡
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	✅	—	—	Alpha 通道会合成到白色背景上
PNG	—	✅	✅	最适合图形和扁平插画

支持的输入类型： .png .jpg .jpeg .webp .tiff .bmp .avif

---

🔒 隐私

所有处理均通过 Pillow 在本地运行。不会将任何图像数据上传到服务器。
此 MCP 服务是 compressfile.pro 的本地配套工具，该网站在浏览器中提供相同功能，且无需将数据上传到服务器。

---

📋 要求

mcp[server]
Pillow
pillow-avif-plugin
imagehash

Python 3.9 或更高版本。

---

📄 许可证

MIT