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：从源代码构建
- 克隆存储库：
git clone https://github.com/okooo5km/zipic-mcp-server.git
cd zipic-mcp-server- 构建项目：
swift build -c release- 安装二进制文件：
# 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构建的。
