zipic

Zipic MCP Server provides image compression capabilities via the MCP (Model Context Protocol) interface. It exposes two main tools: quickCompress for fast, default-quality image compression, and advancedCompress for fine-grained control over quality, output format, and resizing. You can compress single images or entire directories, and you can choose to overwrite originals or save the results alongside them. Use the quickCompress tool when you need a quick size reduction with minimal configuration, and switch to advancedCompress when you require precise control over level (quality), format (jpeg, webp, heic, avif, png, or original), and dimensions. The server is implemented in Swift and leverages the MCP Swift SDK to integrate into Claude, Cursor, or other MCP-enabled environments.

Prerequisites:

• macOS 14.0 or later
• Swift 6.0 or later
• MCP Swift SDK 0.2.0 or later

Option A: One-Line Installation (if available via a prebuilt binary)

• Follow the project’s one-line installer (if provided):

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

Option B: Build from Source

1. Clone the repository

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

2. Build the project in release mode

swift build -c release

3. Install the binary to your local bin path (example)

mkdir -p ~/.local/bin
cp $(swift build -c release --show-bin-path)/zipic-mcp-server ~/.local/bin/

4. Ensure the binary directory is in your PATH

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

Configuration usage:

• The server is started by invoking the binary: zipic-mcp-server
• You can pass CLI options (as described in the project) or rely on MCP integrations to supply the mcpServers configuration.

Tips and common issues:

• Ensure macOS 14.0+ and Swift 6.0+ are installed prior to building.
• If you encounter permission errors after installation, verify that ~/.local/bin is in your PATH.
• When using advancedCompress, valid formats include: original, jpeg, webp, heic, avif, png. Width/Height of 0 preserves auto-adjustment.
• Use absolute file paths when providing URLs to images to avoid path resolution issues in integration environments.
• For batch processing, you can point URLs to directories containing images; the server will traverse appropriately.
• If your environment uses Claude.app or Cursor, configure the mcpServers block with the command zipic-mcp-server to enable integration.