Zipic

Swift-based MCP server that compresses and optimizes images via quick or advanced compression tools.

other

4

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "okooo5km-zipic-mcp-server": {
      "command": "zipic-mcp-server",
      "args": []
    }
  }
}

Zipic MCP Server is a Swift-based MCP server that lets AI systems compress and optimize images through simple or advanced controls. It supports batch processing, multiple output formats, and optional resizing, helping you reduce image sizes for web performance, storage savings, and format conversions while preserving quality objectives.

How to use

You use Zipic MCP Server by running the local server binary and connecting your MCP client to it. The Quick Compression tool lets you compress one or more images with default settings. The Advanced Compression tool lets you tighten quality, choose the output format, and resize images. When you configure your client, point it to the local server command so it can send image paths (absolute file paths) and receive compressed outputs. You can process single images, entire directories, or batches, and you can choose to replace originals or save the results beside them.

How to install

Prerequisites you need before installing Zipic MCP Server are Swift 6.0 or later and macOS 14.0 or later.

Option 1: One-Line Installation (curl) Install the latest version to your user local bin directory.

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

The installer will create ~/.local/bin if it doesn’t exist, add this directory to your PATH, download the latest release, and make the binary executable.

Option 2: Build from Source Clone the repository, build in release mode, and install the binary to your local bin directory.

git clone https://github.com/okooo5km/zipic-mcp-server.git
cd zipic-mcp-server
swift build -c release

Install the binary to your user directory and ensure it is in your PATH.

mkdir -p ~/.local/bin
cp $(swift build -c release --show-bin-path)/zipic-mcp-server ~/.local/bin/
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Available tools

quickCompress

Quickly compress images with default settings. Takes an array of file paths pointing to images or directories containing images.

advancedCompress

Compress images with fine-tuned settings: level (1-6), format (original, jpeg, webp, heic, avif, png), width, height, suffix, and output directory.