MiCompress
Compress images, PDFs, video, audio, documents & archives via micompress.com
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
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>"
}
}
}
}
Variables d'environnement
MICOMPRESS_API_KEYsecret Optional personal API key from https://micompress.com/account (bigger files, monthly allowance).
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent 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-mcp
Claude 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.
Questions fréquentes
Qu'est-ce que MiCompress ?
Compress images, PDFs, video, audio, documents & archives via micompress.com
Comment installer MiCompress ?
Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour MiCompress ?
Oui. Il attend MICOMPRESS_API_KEY, à renseigner dans sa configuration.
MiCompress est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient MiCompress ?
Il est publié par micompress. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.