关于 MiCompress
MiCompress 是供 Agent 使用的 MCP 服务,通过 micompress.com 压缩文件。它支持多种媒体和文档格式,可设置压缩预设并将结果写入本地文件。
主要功能
- 01压缩图像、PDF、视频、音频、文档和归档文件
- 02选择无损、推荐或极限预设
- 03设置图像最大宽度
- 04将压缩结果写入磁盘
- 05列出支持的文件格式
适用场景
- 01缩小资源文件夹中的图像
- 02压缩视频或音频文件
- 03生成体积更小的文档或归档文件
MCP 相关
该 MCP 服务向 MCP 客户端提供文件压缩和格式列表工具。文件会上传至 micompress.com 处理,压缩结果写入磁盘。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
docker run -i --rm -e MICOMPRESS_API_KEY docker.io/huuhuybn/micompress-mcp:0.1.2MICOMPRESS_API_KEY密钥Optional personal API key from https://micompress.com/account (bigger files, monthly allowance).本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
micompress-mcp
一个 MCP 服务,可让 AI Agent 压缩图像、PDF、视频、音频、文档和压缩包。 由 micompress.com 提供支持。
向助手说 “压缩 ./assets 中的截图”,它就会完成操作——无需手动上传,也无需使用单独的工具。适用于任何 Model Context Protocol 客户端:Claude Desktop、Claude Code、Cursor 等。
配置
Claude Code
claude mcp add micompress -- npx -y micompress-mcp
Claude Desktop / Cursor
添加到 MCP 配置中(Desktop 上的配置文件为 claude_desktop_config.json):
{
"mcpServers": {
"micompress": {
"command": "npx",
"args": ["-y", "micompress-mcp"]
}
}
}
工具
compress_file
压缩文件,并将较小的版本写入磁盘。
| 输入 | 说明 |
|---|---|
path (必填) | 要压缩的文件 |
output_path | 写入位置。默认为输入路径并添加 -min 后缀。传入输入路径即可覆盖原文件。 |
preset | lossless · recommended(默认)· extreme |
max_width | 仅适用于图像——将图像缩小到此像素宽度 |
返回压缩前后的大小,以及输出路径。文件字节内容绝不会返回给模型——仅返回摘要,因此大文件不会占满上下文窗口。
list_supported_formats
按类别列出所有支持的扩展名。
支持的格式
| 类别 | 格式 |
|---|---|
| 图像 | jpg, png, webp, gif, bmp, tiff, avif, svg, heic, psd, dng, raw, cr2, arw, nef |
| PDF / 文档 | pdf, docx, xlsx, pptx, doc, ppt, xls, epub, odt, ods, html, csv, txt, rtf |
| 视频 | mp4, mov, avi, mkv, webm, m4v, wmv, flv |
| 音频 | mp3, wav, flac, ogg, m4a, aac, opus |
| 压缩包 | zip, 7z, tar, gz |
完整列表:https://micompress.com/all-tools
工作原理
文件会通过 HTTPS 上传到 micompress.com,并使用网站相同的引擎进行压缩(mozjpeg、pngquant、gifski、Ghostscript、ffmpeg 等),然后写回磁盘。匿名使用受各类型的文件大小限制(图像 20MB、视频 50MB 等)。
请仅对你愿意发送给第三方服务的文件使用此工具。 Agent 会传入路径;文件内容会离开你的设备。
要求
Node.js >= 18
许可证
MIT © MiCompress
更喜欢使用图形界面,或需要处理更大的文件? 请使用 micompress.com。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。