Zipic MCP Server
About
A Model Context Protocol server that provides image compression and optimization capabilities through Zipic app.
Details
- Author
- okooo5km
- GitHub stars
- 4
- Downloads
- 140
- Categories
- Other
Jump to
- Quick image compression with default settings
- Advanced compression with fine-tuned level, format, and dimensions
- Output supports JPEG, WebP, HEIC, AVIF, and PNG
- Batch compress multiple images or entire directories
- Option to replace originals or save with a suffix
Install via one-line curl command or build from source with Swift 6.0+. Configure the server in MCP clients like Claude.app or Cursor by adding a mcpServers entry with the command zipic-mcp-server. The server exposes two tools: quickCompress and advancedCompress.
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)
The easiest way to install is with the one-line installer, which automatically downloads the latest version and installs it to ~/.local/bin in your home 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 (in .zshrc or .bashrc)
Download and install the latest version
Make the binary executable
Option 2: 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:
swift build -c release
3. Install the binary:
# 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:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # or ~/.bashrc
source ~/.zshrc # or source ~/.bashrc
Command Line Arguments
The server supports the following 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
Example usage:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
