MiCompress について
MiCompressは、micompress.comを通じてファイルを圧縮するエージェント向けMCPサーバーです。複数のメディアや文書形式に対応し、圧縮プリセットを選んで結果をローカルに保存できます。
主な機能
- 01画像、PDF、動画、音声、文書、アーカイブの圧縮
- 02可逆、推奨、強圧縮プリセットの選択
- 03画像の最大幅の指定
- 04圧縮結果のディスク保存
- 05対応ファイル形式の一覧表示
活用シーン
- 01アセットフォルダー内の画像を縮小
- 02動画や音声ファイルの圧縮
- 03文書やアーカイブの容量削減
MCP 対応
MCPサーバーは、ファイル圧縮と形式一覧のツールをMCPクライアントに公開します。ファイルはmicompress.comにアップロードされて処理され、圧縮結果はディスクに保存されます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
docker run -i --rm -e MICOMPRESS_API_KEY docker.io/huuhuybn/micompress-mcp:0.1.2MICOMPRESS_API_KEYシークレットOptional personal API key from https://micompress.com/account (bigger files, monthly allowance).ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
micompress-mcp
AI エージェントが画像、PDF、動画、音声、ドキュメント、アーカイブを圧縮できるMCP サーバーです。 micompress.com を利用しています。
アシスタントに 「./assets 内のスクリーンショットを圧縮して」 と頼むだけで実行できます。手動でのアップロードや、別のツールは不要です。Model Context Protocol に対応するあらゆるクライアントで動作します。Claude Desktop、Claude Code、Cursor などに対応しています。
セットアップ
Claude Code
claude mcp add micompress -- npx -y micompress-mcp
Claude Desktop / Cursor
MCP 設定に追加します(Desktop では claude_desktop_config.json)。
{
"mcpServers": {
"micompress": {
"command": "npx",
"args": ["-y", "micompress-mcp"]
}
}
}
ツール
compress_file
ファイルを圧縮し、サイズを小さくしたファイルをディスクに書き込みます。
| 入力 | 説明 |
|---|---|
path (required) | 圧縮するファイル |
output_path | 出力先です。デフォルトでは、入力パスに -min の接尾辞を付けたパスになります。入力パスを指定すると、元のファイルを上書きします。 |
preset | lossless · recommended(デフォルト) · extreme |
max_width | 画像のみ — 指定した幅(ピクセル)まで縮小します |
圧縮前後のサイズと出力パスを返します。ファイルのバイトデータがモデルに返されることはありません。要約のみを返すため、大きなファイルでコンテキストウィンドウが埋まることはありません。
list_supported_formats
対応する拡張子をすべて、カテゴリ別に一覧表示します。
対応形式
| カテゴリ | 形式 |
|---|---|
| 画像 | jpg, png, webp, gif, bmp, tiff, avif, svg, heic, psd, dng, raw, cr2, arw, nef |
| PDF / ドキュメント | pdf, docx, xlsx, pptx, doc, ppt, xls, epub, odt, ods, html, csv, txt, rtf |
| 動画 | mp4, mov, avi, mkv, webm, m4v, wmv, flv |
| 音声 | mp3, wav, flac, ogg, m4a, aac, opus |
| アーカイブ | zip, 7z, tar, gz |
全形式の一覧:https://micompress.com/all-tools
仕組み
ファイルは HTTPS 経由で micompress.com にアップロードされ、ウェブサイトと同じエンジン(mozjpeg、pngquant、gifski、Ghostscript、ffmpeg、…)で圧縮された後、ディスクに書き戻されます。匿名での利用には、種類ごとのサイズ制限があります(画像は 20MB、動画は 50MB など)。
第三者サービスへの送信に問題のないファイルを指定してください。 エージェントに渡すのはパスですが、ファイルの内容はお使いのマシンから外部に送信されます。
必要要件
Node.js >= 18
ライセンス
MIT © MiCompress
UI を使いたい場合や、さらに大きなファイルが必要な場合は、 micompress.com をご利用ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。