MiCompress
Compress images, PDFs, video, audio, documents & archives via micompress.com
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
docker.io/huuhuybn/micompress-mcp:0.1.2claude mcp add micompress -e 'MICOMPRESS_API_KEY=<your micompress_api_key>' -- docker run -i --rm docker.io/huuhuybn/micompress-mcp:0.1.2{
"mcpServers": {
"micompress": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/huuhuybn/micompress-mcp:0.1.2"
],
"env": {
"MICOMPRESS_API_KEY": "<your micompress_api_key>"
}
}
}
}Environment variables
MICOMPRESS_API_KEYsecret Optional personal API key from https://micompress.com/account (bigger files, monthly allowance).
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
micompress-mcp
An MCP server that lets AI agents compress images, PDFs, video, audio, documents & archives. Powered by **micompress.com**.
Ask your assistant "compress the screenshots in ./assets" and it will — no manual upload, no separate tool. Works with any Model Context Protocol client: Claude Desktop, Claude Code, Cursor, and others.
Setup
Claude Code
claude mcp add micompress -- npx -y micompress-mcpClaude Desktop / Cursor
Add to your MCP config (claude_desktop_config.json on Desktop):
{
"mcpServers": {
"micompress": {
"command": "npx",
"args": ["-y", "micompress-mcp"]
}
}
}Tools
compress_file
Compresses a file and writes the smaller version to disk.
| Input | Description |
|---|---|
path (required) | File to compress |
output_path | Where to write it. Defaults to the input path with a -min suffix. Pass the input path to overwrite in place. |
preset | lossless · recommended (default) · extreme |
max_width | Images only — resize down to this width in pixels |
Returns the size before and after, plus the output path. The file bytes are never returned to the model — only the summary, so a large file can't flood the context window.
list_supported_formats
Lists every accepted extension, grouped by category.
Supported formats
| Category | Formats |
|---|---|
| Image | jpg, png, webp, gif, bmp, tiff, avif, svg, heic, psd, dng, raw, cr2, arw, nef |
| PDF / Docs | pdf, docx, xlsx, pptx, doc, ppt, xls, epub, odt, ods, html, csv, txt, rtf |
| Video | mp4, mov, avi, mkv, webm, m4v, wmv, flv |
| Audio | mp3, wav, flac, ogg, m4a, aac, opus |
| Archive | zip, 7z, tar, gz |
Full list: **https://micompress.com/all-tools**
How it works
Files are uploaded over HTTPS to micompress.com and compressed with the same engine the website uses (mozjpeg, pngquant, gifski, Ghostscript, ffmpeg, …), then written back to disk. Anonymous use works within per-type size limits (images 20MB, video 50MB, …).
Point it at files you're comfortable sending to a third-party service. The agent passes a path; the file's contents leave your machine.
Requirements
Node.js >= 18
License
MIT © MiCompress
Prefer a UI, or need bigger files? Use micompress.com.
Frequently asked questions
What is MiCompress?
Compress images, PDFs, video, audio, documents & archives via micompress.com
How do I install MiCompress?
It runs on your machine. In Claude Code: claude mcp add micompress -e 'MICOMPRESS_API_KEY=<your micompress_api_key>' -- docker run -i --rm docker.io/huuhuybn/micompress-mcp:0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does MiCompress need an API key?
Yes. It expects MICOMPRESS_API_KEY, which you set in its configuration.
Is MiCompress open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains MiCompress?
It is published by micompress. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.