English Français العربية

MiCompress

السجل الرسمي الإنتاجية

Compress images, PDFs, video, audio, documents & archives via micompress.com

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

OCI package docker.io/huuhuybn/micompress-mcp:0.1.2
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "micompress": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/huuhuybn/micompress-mcp:0.1.2"
            ],
            "env": {
                "MICOMPRESS_API_KEY": "<your micompress_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • MICOMPRESS_API_KEY سري Optional personal API key from https://micompress.com/account (bigger files, monthly allowance).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. micompress-mcp
  2. Setup
  3. Tools
  4. Supported formats
  5. How it works
  6. Requirements
  7. License

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.

InputDescription
path (required)File to compress
output_pathWhere to write it. Defaults to the input path with a -min suffix. Pass the input path to overwrite in place.
presetlossless · recommended (default) · extreme
max_widthImages 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

CategoryFormats
Imagejpg, png, webp, gif, bmp, tiff, avif, svg, heic, psd, dng, raw, cr2, arw, nef
PDF / Docspdf, docx, xlsx, pptx, doc, ppt, xls, epub, odt, ods, html, csv, txt, rtf
Videomp4, mov, avi, mkv, webm, m4v, wmv, flv
Audiomp3, wav, flac, ogg, m4a, aac, opus
Archivezip, 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.

الأسئلة الشائعة

ما هو MiCompress؟

Compress images, PDFs, video, audio, documents & archives via micompress.com

كيف أثبّت MiCompress؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج MiCompress إلى مفتاح API؟

نعم. يتطلب MICOMPRESS_API_KEY، وتضبطها في إعداداته.

هل MiCompress مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون MiCompress؟

ينشره micompress. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.