ZIP MCP Server
2025.04.03
9
TypeScript文件压缩数据压缩文件管理其它
ZIP MCP Server 是一个基于 fastMCP 和 zip.js 的压缩服务器，实现了模型上下文协议（MCP）。该项目提供完全参数控制的 ZIP 压缩、解压缩以及查询压缩包信息的功能。
View on GitHub
Overview
基本能力
产品定位
ZIP MCP Server 是一个专注于文件压缩和解压缩的服务，支持多种压缩参数设置和加密功能。
核心功能
- 支持文件和数据的压缩与解压缩
- 支持多文件打包压缩
- 提供压缩级别控制（0-9）
- 支持密码保护和加密强度设置
- 提供压缩包元数据查询功能
适用场景
- 需要批量压缩或解压缩文件的场景
- 需要对压缩文件进行加密保护的场景
- 需要查询压缩包详细信息的场景
工具列表
- 压缩工具 (compress)
- 功能：压缩本地文件或目录为 ZIP 文件
-
参数：输入路径、输出路径、压缩选项（级别、密码、加密强度等）
-
解压缩工具 (decompress)
- 功能：解压本地 ZIP 文件到指定目录
-
参数：输入 ZIP 文件路径、输出目录、解压选项（密码、覆盖等）
-
ZIP 信息工具 (getZipInfo)
- 功能：获取本地 ZIP 文件的元数据信息
-
参数：输入 ZIP 文件路径、选项（密码等）
-
测试工具 (echo)
- 功能：返回输入消息以测试服务是否正常运行
- 参数：要返回的消息
常见问题解答
- 如何测试服务是否正常运行？
使用
echo工具发送测试消息。 - 如何设置压缩级别？
在
compress工具的options参数中设置level值（0-9）。 - 如何加密压缩文件？
在
compress工具的options参数中设置password和encryptionStrength。
使用教程
使用依赖
需要安装 Node.js 和 npm。
安装教程
npm install -g zip-mcp
配置 MCP
在 MCP JSON 配置中添加以下内容：
{
"mcpServers": {
"zip-mcp": {
"command": "zip-mcp",
"args": []
}
}
}
调试方式
- 使用
echo工具测试服务是否正常运行：
await client.executeTool("echo", {
message: "Hello, ZIP MCP Server!",
});
- 尝试压缩和解压缩小文件测试基本功能。
- 检查返回的错误信息以定位问题。