huuhuybn/micompress-mcp repository overview

⁠MiCompress MCP server (Docker)

MCP server that lets AI agents (Claude, Cursor, VS Code, …) compress images, PDFs, video, audio, documents and archives through micompress.com⁠. Registry name: com.micompress/mcp.

Files are read from a directory you mount at /data; the compressed copy is written next to the original with a -min suffix. Only a short summary goes back to the model, never the file bytes.

⁠Use with Claude Code

claude mcp add micompress -- docker run -i --rm -v "$PWD":/data huuhuybn/micompress-mcp:0.1.2

⁠Use with any MCP client (JSON config)

{
  "mcpServers": {
    "micompress": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/path/to/files:/data",
               "-e", "MICOMPRESS_API_KEY", "huuhuybn/micompress-mcp:0.1.2"],
      "env": { "MICOMPRESS_API_KEY": "mc_your_key_here" }
    }
  }
}

⁠API key (optional)

Without a key the server works anonymously within small size limits (images 20MB, video 50MB). With your personal key from micompress.com/account⁠ you get files up to 100MB and a monthly quota:

Pass it as the MICOMPRESS_API_KEY environment variable. The key never reaches the model. Upgrade at micompress.com/plans⁠.

⁠Also available

• npm: npx -y micompress-mcp
• CLI image: huuhuybn/micompress⁠
• Source: github.com/micompress/micompress-mcp⁠