项目简介
ZIP MCP Server 是一个基于 fastMCP 和 zip.js 的压缩服务器，实现了 Model Context Protocol (MCP) 协议。本项目提供了全参数可控的 ZIP 压缩、解压缩和查询压缩包信息功能。
功能特点
- 支持文件和数据的压缩与解压缩
- 支持多文件打包压缩
- 提供压缩级别控制 (0-9)
- 支持密码保护和加密强度设置
- 提供压缩包元数据查询功能
项目链接
如果觉得项目不错的话，欢迎点个 Star ⭐ 支持！
https://github.com/7gugu/zip-mcp
范例截图
图中使用的是 Raycast + MCP 插件
安装与使用
-
克隆项目：
git clone <repository-url>
cd zip-mcp
-
安装依赖：
npm install
-
生成 MCP JSON：
npm run json
{
"mcpServers": {
"zip-mcp": {
"command": "npx",
"args": [
"tsx",
"<ABSOLUTE PATH>src/index.ts"
]
}
}
}
-
将 MCP JSON 配置到 AI Client 中
MCP 工具说明
ZIP MCP Server 提供了以下工具，可通过 MCP 协议调用：
压缩工具 (compress)
将本地文件或目录压缩为 ZIP 文件。
-
参数:
input: 要压缩的文件或目录路径（字符串或字符串数组）output: 输出 ZIP 文件的路径options: 压缩选项（可选）level: 压缩级别 (0-9 ，默认为 5)password: 密码保护encryptionStrength: 加密强度 (1-3)overwrite: 是否覆盖现有文件 (布尔值)
-
返回:
- 成功: 包含成功信息的文本内容
- 失败: 包含错误信息的文本内容
解压工具 (decompress)
解压本地 ZIP 文件到指定目录。
-
参数:
input: ZIP 文件路径output: 输出目录路径options: 解压选项（可选）password: 解压密码overwrite: 是否覆盖现有文件 (布尔值)createDirectories: 是否创建不存在的目录 (布尔值)
-
返回:
- 成功: 包含解压结果信息的文本内容
- 失败: 包含错误信息的文本内容
ZIP 信息工具 (getZipInfo)
获取本地 ZIP 文件的元数据信息。
-
参数:
input: ZIP 文件路径options: 选项（可选）password: 解压密码
-
返回:
-
成功: 包含 ZIP 文件详细信息的文本内容，包括：
- 总文件数
- 总大小
- 压缩后大小
- 压缩率
- 每个文件的详细信息
- 失败: 包含错误信息的文本内容
测试工具 (echo)
返回输入的消息，用于测试服务是否正常运行。
联系方式
| 
