Zipic MCP Server
About
A Model Context Protocol server that provides image compression and optimization capabilities through Zipic app.
Explore
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
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
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
Add to your Claude settings:
"mcpServers": {
"zipic": {
"command": "zipic-mcp-server"
}
}
Add the following configuration to your Cursor editor's Settings - mcp.json:
{
"mcpServers": {
"zipic": {
"command": "zipic-mcp-server"
}
}
}
{
"urls": [
"/Users/username/Desktop/photo.jpg",
"/Users/username/Pictures/vacation"
]
}
```
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
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
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
> 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.
