Zipic MCP Server

A Model Context Protocol server that provides image compression capabilities. This server enables LLMs to compress and optimize images through simple and advanced compression tools. This is a Swift implementation of a zipic MCP server using the MCP Swift SDK.

Features

• **Quick Image Compression**: Rapidly compress images with default settings

• **Advanced Compression**: Fine-tune compression settings including quality level, format, and dimensions

• **Multiple Format Support**: Output images in JPEG, WebP, HEIC, AVIF, or PNG formats

• **Batch Processing**: Compress multiple images or entire directories at once

• **Size Preservation Option**: Choose to replace original files or save alongside them

Available Tools

• `quickCompress` - Quickly compress images with default settings * `urls` (array, required): Array of file paths pointing to images or directories containing images

• `advancedCompress` - Compress images with fine-tuned settings * `urls` (array, required): Array of file paths pointing to images or directories containing images * `level` (integer, optional): Compression level from 1-6 (1=highest quality, 6=maximum compression) * `format` (string, optional): Output format ("original", "jpeg", "webp", "heic", "avif", "png") * `width` (integer, optional): Target width for resizing (0 for auto-adjustment) * `height` (integer, optional): Target height for resizing (0 for auto-adjustment) * `suffix` (string, optional): Custom suffix for compressed file names * `directory` (string, optional): Output directory path for compressed images

Installation

Option 1: One-Line Installation (curl)

• Create `~/.local/bin` if it doesn't exist

• Add this directory to your PATH (in .zshrc or .bashrc)

• Download and install the latest version

• Make the binary executable

Option 2: Build from Source

1. Clone the repository: ```bash git clone https://github.com/okooo5km/zipic-mcp-server.git cd zipic-mcp-server ```

2. Build the project: ```bash swift build -c release ```

3. Install the binary: ```bash # 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/ ``` Make sure `~/.local/bin` is in your PATH by adding to your shell configuration file: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # or ~/.bashrc source ~/.zshrc # or source ~/.bashrc ```

Command Line Arguments

• `-h, --help`: Display help information about the server, its usage, and available options

• `-v, --version`: Display the version number of the zipic-mcp-server

Configure for Claude.app

Configure for Cursor

Example System Prompt

Development Requirements

• Swift 6.0 or later

• macOS 14.0 or later

• MCP Swift SDK 0.2.0 or later

Usage Examples

Quick Compression

Advanced Compression

Use Cases

• **Website Optimization**: Reduce image sizes for faster web performance

• **Storage Management**: Compress large photo libraries to save disk space

• **Format Conversion**: Convert between image formats for compatibility

• **Batch Processing**: Process multiple images with consistent settings

• **Social Media Preparation**: Optimize images for specific platforms

Version History

Support the Project

• Star the project on GitHub

• Report bugs or suggest features

• Support via:

License

About