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 formats
- Resize images to specific dimensions

Use the following tools appropriately:
- `quickCompress` for simple compression tasks with default settings
- `advancedCompress` when the user needs fine-grained control over quality, format, and dimensions

Ask for absolute file paths to images when the user wants to compress files.

Development Requirements

• Swift 6.0 or later
• macOS 14.0 or later
• MCP Swift SDK 0.2.0 or later

Usage Examples

Quick Compression

{
  "urls": [
    "/Users/username/Desktop/photo.jpg",
    "/Users/username/Pictures/vacation"
  ]
}

Advanced Compression

{
  "urls": ["/Users/username/Desktop/photo.jpg"],
  "level": 2,
  "format": "webp",
  "width": 1200,
  "height": 0
}

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

See GitHub Releases for version history and changelog.

☕️ Support the Project

If you find Zipic MCP Server helpful, please consider supporting its development:

• ⭐️ Star the project on GitHub
• 🐛 Report bugs or suggest features
• 💝 Support via:

License

zipic-mcp-server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.

About

A Swift implementation of an image compression server for Model Context Protocol (MCP), enabling AI assistants to compress and optimize images directly. This project is built using the MCP Swift SDK.