Zipic MCP Server

Zipic MCP Server

一个提供图像压缩功能的模型上下文协议服务。该服务使大模型能够通过简单和高级压缩工具压缩并优化图像。这是使用 MCP Swift SDK 实现的 zipic MCP 服务 Swift 版本。

✨ 功能

• 快速图像压缩：使用默认设置快速压缩图像
• 高级压缩：微调压缩设置，包括质量级别、格式和尺寸
• 支持多种格式：输出 JPEG、WebP、HEIC、AVIF 或 PNG 格式的图像
• 批量处理：一次压缩多张图像或整个目录
• 保留原文件选项：选择替换原文件或将压缩文件保存到同一位置

可用工具

• quickCompress - 使用默认设置快速压缩图像

  • urls（数组，必填）：指向图像文件或包含图像的目录的文件路径数组

• advancedCompress - 使用微调后的设置压缩图像

  • urls（数组，必填）：指向图像文件或包含图像的目录的文件路径数组
  • level（整数，可选）：压缩级别，范围为 1–6（1 = 最高质量，6 = 最大压缩）
  • format（字符串，可选）：输出格式（"original"、"jpeg"、"webp"、"heic"、"avif"、"png"）
  • width（整数，可选）：调整尺寸后的目标宽度（0 表示自动调整）
  • height（整数，可选）：调整尺寸后的目标高度（0 表示自动调整）
  • suffix（字符串，可选）：压缩文件名的自定义后缀
  • directory（字符串，可选）：压缩图像的输出目录路径

安装

选项 1：一键安装（curl）

最简单的安装方式是使用一键安装程序，它会自动下载最新版本并将其安装到主目录下的 ~/.local/bin：

curl -fsSL https://raw.githubusercontent.com/okooo5km/zipic-mcp-server/main/install.sh | bash

安装程序将会：

• 如果 ~/.local/bin 不存在，则创建该目录
• 将此目录添加到 PATH（在 .zshrc 或 .bashrc 中）
• 下载并安装最新版本
• 将二进制文件设为可执行

选项 2：从源代码构建

1. 克隆仓库：

   git clone https://github.com/okooo5km/zipic-mcp-server.git
   cd zipic-mcp-server
   

2. 构建项目：

   swift build -c release
   

3. 安装二进制文件：

   # 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/
   

   确保 ~/.local/bin 位于 PATH 中，可将其添加到 Shell 配置文件：

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
   source ~/.zshrc  # or source ~/.bashrc
   

命令行参数

该服务支持以下命令行参数：

• -h, --help：显示有关服务、其用法和可用选项的帮助信息
• -v, --version：显示 zipic-mcp-server 的版本号

用法示例：

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

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

配置 Claude.app

添加到 Claude 设置中：

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

配置 Cursor

将以下配置添加到 Cursor 编辑器的 Settings - mcp.json：

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

系统提示词示例

你可以使用以下系统提示词，帮助 Claude 有效地使用 zipic-mcp-server：

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.

开发要求

• Swift 6.0 或更高版本
• macOS 14.0 或更高版本
• MCP Swift SDK 0.2.0 或更高版本

使用示例

快速压缩

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

高级压缩

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

使用场景

• 网站优化：减小图像文件大小，提升网页加载速度
• 存储管理：压缩大型照片库以节省磁盘空间
• 格式转换：在不同图像格式之间转换，以确保兼容性
• 批量处理：使用一致的设置处理多张图像
• 社交媒体准备：针对特定平台优化图像

版本历史

请参阅 GitHub Releases，查看版本历史和更新日志。

☕️ 支持项目

如果您觉得 Zipic MCP Server 有帮助，请考虑支持其开发：

• ⭐️ 在 GitHub 上为项目点星
• 🐛 报告错误或提出功能建议
• 💝 通过以下方式支持：

许可证

zipic-mcp-server 根据 MIT 许可证授权。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。

关于

这是一个使用 Swift 实现的图像压缩服务，用于 Model Context Protocol (MCP)，可让 AI 助手直接压缩和优化图像。本项目使用 MCP Swift SDK 构建。