AI导哈

图像压缩服务器

Zipic MCP Server 是一个基于 Model Context Protocol 的图像压缩服务器，提供快速和高级的图像压缩功能，支持多种格式和批量处理，适用于网站优化、存储管理和社交媒体准备等场景。

  • by okooo5km
  • Swift
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 okooo5km/zipic-mcp-server

使用说明

Zipic MCP服务器

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

✨ 特性

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

可用工具

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

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

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

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

安装

选项1：单线安装（卷曲）

最简单的安装方法是使用单行安装程序，它会自动下载最新版本并将其安装到 ~/.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 通过将以下内容添加到shell配置文件中，将其添加到PATH中：

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

命令行参数

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

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

示例用法：

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

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

为Claude.app进行配置

添加到您的Claude设置中：

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

配置光标

将以下配置添加到游标编辑器的设置-mcp.json中：

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

系统提示示例

您可以使用以下系统提示来帮助Claude有效地利用zipic-mcp服务器：

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
}

用例

  • 网站优化：减小图像大小以提高web性能
  • 存储管理：压缩大型照片库以节省磁盘空间
  • 格式转换：在图像格式之间进行转换以实现兼容性
  • 批处理：使用一致的设置处理多个图像
  • 社交媒体准备：针对特定平台优化图像

版本历史记录

有关版本历史记录和更改日志，请参阅GitHub Release。

☕️ 支持项目

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

  • ⭐️ 在GitHub上启动该项目
  • 🐛 报告错误或建议功能
  • 💝 支持方式：

许可证

zipic-mcp服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。

关于

用于模型上下文协议（MCP）的图像压缩服务器的Swift实现，使AI助手能够直接压缩和优化图像。这个项目是使用MCP Swift SDK构建的。

相关 MCP