MiCompress — Claude Code MCP server: file compression and setup
MiCompress compresses files through an MCP server and writes the result to disk. Use it to reduce project images, documents, or media files from your coding assistant.
claude mcp add micompress -- docker run -i --rm docker.io/huuhuybn/micompress-mcp:0.1.1What MiCompress does
Give the server a file path and it sends that file to micompress.com for compression, then saves the output locally. It handles images, PDFs and office documents, video, audio, and archives. list_supported_formats reports accepted extensions; compress_file returns the original and resulting sizes along with the output path. The model receives a summary rather than the file contents.
For Claude Code, the setup command below runs the server in Docker. Anonymous use has size caps that vary by file type; MICOMPRESS_API_KEY allows files up to 100 MB. Files leave your machine and go to a third-party service, so this setup is unsuitable for data you cannot send there.
What it helps with
- shrink images in a project folder
- compress a PDF and save the output locally
- reduce video or audio file sizes
- check which extensions the server accepts
Example prompts for the agent
- Compress the images in
assets. - Reduce
report.pdfand save the result beside it. - Show me the file formats this server accepts.
How to install MiCompress
Platform CLI
claude mcp add micompress -- docker run -i --rm docker.io/huuhuybn/micompress-mcp:0.1.1Platform CLI
codex mcp add micompress -- docker run -i --rm docker.io/huuhuybn/micompress-mcp:0.1.1Config file
{
"mcpServers": {
"micompress": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/huuhuybn/micompress-mcp:0.1.1"
]
}
}
}Config file
{
"servers": {
"micompress": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/huuhuybn/micompress-mcp:0.1.1"
]
}
}
}Platform CLI
gemini mcp add micompress docker run -i --rm docker.io/huuhuybn/micompress-mcp:0.1.1Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MiCompress
How do I install MiCompress in Claude Code?
Run claude mcp add micompress -- docker run -i --rm docker.io/huuhuybn/micompress-mcp:0.1.1.
What does MiCompress do?
It compresses images, documents, video, audio, and archives through micompress.com, then saves the result to disk.
Do I need an API key to use MiCompress?
It can run without a key, with per-type size caps. Set MICOMPRESS_API_KEY to process files up to 100 MB; files are sent to micompress.com.
