Zipic MCP Server

Zipic MCP Server

画像圧縮機能を提供する Model Context Protocol サーバーです。このサーバーを使うと、シンプルな圧縮ツールや高度な圧縮ツールを通じて、LLM が画像を圧縮・最適化できます。MCP Swift SDK を使用した zipic MCP サーバーの Swift 実装です。

✨ 機能

• クイック画像圧縮：デフォルト設定で画像をすばやく圧縮します
• 高度な圧縮：品質レベル、形式、寸法などの圧縮設定を細かく調整します
• 複数形式のサポート：JPEG、WebP、HEIC、AVIF、PNG 形式で画像を出力します
• バッチ処理：複数の画像やディレクトリ全体を一度に圧縮します
• サイズ保持オプション：元のファイルを置き換えるか、元のファイルと並べて保存するかを選択できます

利用可能なツール

• quickCompress - デフォルト設定で画像をすばやく圧縮します

  • urls（配列、必須）：画像、または画像を含むディレクトリを指すファイルパスの配列

• advancedCompress - 設定を細かく調整して画像を圧縮します

  • urls（配列、必須）：画像、または画像を含むディレクトリを指すファイルパスの配列
  • level（整数、任意）：圧縮レベル。1～6（1＝最高画質、6＝最大圧縮）
  • format（文字列、任意）：出力形式（"original"、"jpeg"、"webp"、"heic"、"avif"、"png"）
  • width（整数、任意）：サイズ変更後の幅（自動調整する場合は0）
  • height（整数、任意）：サイズ変更後の高さ（自動調整する場合は0）
  • suffix（文字列、任意）：圧縮後のファイル名に付けるカスタム接尾辞
  • directory（文字列、任意）：圧縮画像の出力ディレクトリパス

インストール

オプション1：1行でインストール（curl）

最も簡単なインストール方法は、1行のインストーラーを使用することです。最新バージョンを自動的にダウンロードし、ホームディレクトリ内の ~/.local/bin にインストールします。

curl -fsSL https://raw.githubusercontent.com/okooo5km/zipic-mcp-server/main/install.sh | bash

インストーラーは次の処理を行います。

• ~/.local/bin が存在しない場合は作成します
• このディレクトリを PATH に追加します（.zshrc または .bashrc）
• 最新バージョンをダウンロードしてインストールします
• バイナリを実行可能にします

オプション2：ソースからビルド

1. リポジトリをクローンします。

   git clone https://github.com/okooo5km/zipic-mcp-server.git
   cd zipic-mcp-server
   

2. プロジェクトをビルドします。

   swift build -c release
   

3. バイナリをインストールします。

   # Install to user directory (recommended, no sudo required)
   mkdir -p ~/.local/bin
   cp $(swift build -c release --show-bin-path)/zipic-mcp-server ~/.local/bin/
   

   シェルの設定ファイルに追加して、~/.local/bin が PATH に含まれていることを確認します。

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
   source ~/.zshrc  # or source ~/.bashrc
   

コマンドライン引数

サーバーは次のコマンドライン引数に対応しています。

• -h, --help：サーバーの情報、使い方、利用可能なオプションを表示します
• -v, --version：zipic-mcp-server のバージョン番号を表示します

使用例：

# Display help information
zipic-mcp-server --help

# Display version information
zipic-mcp-server --version

Claude.app の設定

Claude の設定に追加します。

"mcpServers": {
  "zipic": {
    "command": "zipic-mcp-server"
  }
}

Cursor の設定

次の設定を Cursor エディターの Settings - mcp.json に追加します。

{
  "mcpServers": {
    "zipic": {
      "command": "zipic-mcp-server"
    }
  }
}

システムプロンプトの例

Claude が zipic-mcp-server を効果的に利用できるよう、次のシステムプロンプトを使用できます。

You have access to an image compression tool through MCP. Use this to help users:

- Compress single images or batches of images
- Reduce file size while maintaining quality
- Convert between image formats
- Resize images to specific dimensions

Use the following tools appropriately:
- `quickCompress` for simple compression tasks with default settings
- `advancedCompress` when the user needs fine-grained control over quality, format, and dimensions

Ask for absolute file paths to images when the user wants to compress files.

開発要件

• Swift 6.0 以降
• macOS 14.0 以降
• MCP Swift SDK 0.2.0 以降

使用例

クイック圧縮

{
  "urls": [
    "/Users/username/Desktop/photo.jpg",
    "/Users/username/Pictures/vacation"
  ]
}

高度な圧縮

{
  "urls": ["/Users/username/Desktop/photo.jpg"],
  "level": 2,
  "format": "webp",
  "width": 1200,
  "height": 0
}

使用例

• ウェブサイトの最適化：画像サイズを小さくして、ウェブの表示を高速化します
• ストレージ管理：大容量の写真ライブラリを圧縮して、ディスク容量を節約します
• 形式変換：互換性のために画像形式を相互に変換します
• バッチ処理：複数の画像を一貫した設定で処理します
• ソーシャルメディア向けの準備：特定のプラットフォーム向けに画像を最適化します

バージョン履歴

バージョン履歴と変更履歴については、GitHub Releases をご覧ください。

☕️ プロジェクトを応援する

Zipic MCP Server が役に立ったと感じたら、開発へのご支援をご検討ください。

• ⭐️ GitHub でプロジェクトにスターを付ける
• 🐛 バグを報告する、または機能を提案する
• 💝 以下から支援する：

ライセンス

zipic-mcp-server は MIT ライセンスのもとでライセンスされています。MIT ライセンスの利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。

概要

Model Context Protocol（MCP）向けの画像圧縮サーバーを Swift で実装したもので、AI アシスタントが画像を直接圧縮・最適化できるようにします。このプロジェクトは MCP Swift SDK を使用して構築されています。