使用说明
ZIP MCP 服务器
在 npm 上查看 @loscolmebrothers/zip-mcp
一个MCP(模型上下文协议)服务器,为像Claude这样的AI助手提供ZIP文件的压缩和解压缩功能。
特点/特性
- 压缩文件和目录 压缩成ZIP文件
- 解压ZIP文件 到指定的目录
- 获取ZIP文件的元数据 包括文件列表和压缩信息
- 支持多个输入文件/目录
- 可配置的压缩选项
- 密码保护支持(通过 adm-zip 实现)
安装
npm install
npm run build
使用
作为MCP服务器
在您的Claude桌面配置文件中添加:
MacOS(麦金塔操作系统): ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"zip": {
"command": "npx",
"args": ["-y", "@loscolmebrothers/zip-mcp"]
}
}
}
可用工具
compress
将本地文件或目录压缩成一个ZIP文件。
参数:
input(string | string[]): 要压缩的文件路径或目录output(字符串):输出ZIP文件路径options(可选):overwrite(布尔值):如果输出文件已存在,则覆盖level(数字):压缩级别(0-9)password(字符串):用于加密ZIP文件的密码comment(字符串): ZIP 文件注释encryptionStrength(数字):加密强度(1=AES-128,2=AES-192,3=AES-256)
示例:
{
"input": ["./docs", "./src/index.ts"],
"output": "./archive.zip",
"options": {
"overwrite": true,
"comment": "Project backup"
}
}
decompress
将本地ZIP文件解压到指定目录。
参数:
input(字符串):要解压的ZIP文件路径output(字符串):输出目录路径options(可选):overwrite(boolean): 覆盖现有文件password(字符串):加密ZIP文件的密码createDirectories(boolean):如果输出目录不存在,则创建它
示例:
{
"input": "./archive.zip",
"output": "./extracted",
"options": {
"overwrite": true,
"createDirectories": true
}
}
getZipInfo
获取ZIP文件的元数据信息。
参数:
input(字符串):ZIP 文件路径options(可选):password(字符串):加密ZIP文件的密码
返回值: 包含文件大小、条目数量、文件列表和压缩详情的JSON。
echo
用于测试MCP连接的简单回声工具。
参数:
message(字符串):要回显的消息
发展
# Install dependencies
npm install
# Build the project
npm run build
# The build output will be in ./build/index.js
依赖项
- @modelcontextprotocol/sdk(注:这通常表示一个软件开发包或SDK的名称,直接翻译为“@模型上下文协议/软件开发包”可能不够流畅,具体翻译可能需根据上下文调整,但此处保持原样以体现技术术语的特性) - MCP SDK 用于构建服务器
- adm-zip(可保持原名,若需翻译则为“用于处理ZIP文件的adm工具”或根据具体上下文调整) - ZIP文件操作库
许可证
ISC(Internet Service Center,互联网服务中心)
作者
“danicolms”可以翻译为“达尼科尔姆斯”(注:这是一个音译,实际翻译可能因具体语境和命名规则而有所不同)。不过,需要注意的是,“danicolms”本身并不是一个常见的英文单词或专有名词,它可能是某个特定名称、品牌或专有技术的音译。在中文中,我们通常会根据发音来音译这样的名称
