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:

# Display help information
zipic-mcp-server --help

# Display version information
zipic-mcp-server --version

Configure for Claude.app

Add to your Claude settings:

"mcpServers": {
  "zipic": {
    "command": "zipic-mcp-server"
  }
}

Configure for Cursor

Add the following configuration to your Cursor editor's Settings - mcp.json:

{
  "mcpServers": {
    "zipic": {
      "command": "zipic-mcp-server"
    }
  }
}

Example System Prompt

You can use the following system prompt to help Claude utilize the zipic-mcp-server effectively:

You have access to an image compression tool through MCP. Use this to help users:

- Compress single images or batches of images
- Reduce file size while maintaining quality
- Convert between image f

... [View full README on GitHub](https://github.com/okooo5km/zipic-mcp-server#readme)