ZIP压缩解压服务

一个提供ZIP文件压缩和解压功能的MCP服务器,适用于AI助手如Claude。

  • by loscolmebrothers
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 loscolmebrothers/zip-mcp

使用说明

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

依赖项

许可证

ISC(Internet Service Center,互联网服务中心)

作者

“danicolms”可以翻译为“达尼科尔姆斯”(注:这是一个音译,实际翻译可能因具体语境和命名规则而有所不同)。不过,需要注意的是,“danicolms”本身并不是一个常见的英文单词或专有名词,它可能是某个特定名称、品牌或专有技术的音译。在中文中,我们通常会根据发音来音译这样的名称