MCP 服务器

ZIP-MCP

一个MCP工具，赋予AI压缩和解压缩本地文件的能力。

Tools

compress

Compress local files or directories into a ZIP file

decompress

Decompress local ZIP file to specified directory

getZipInfo

Get metadata information of a local ZIP file

echo

Return the input message (for testing)

README

ZIP MCP 服务器

中文 | English

项目介绍

ZIP MCP 服务器是一个基于 fastMCP 和 zip.js 的压缩服务器，实现了模型上下文协议 (MCP)。该项目提供完全参数控制的 ZIP 压缩、解压缩和查询压缩包信息功能。

特性

支持文件和数据的压缩和解压缩
支持多文件打包压缩
提供压缩级别控制 (0-9)
支持密码保护和加密强度设置
提供压缩包元数据查询功能

项目结构

zip-mcp
├── src
│   ├── index.ts               # 应用入口
│   ├── utils
│   │   └── compression.ts     # 压缩和解压缩实现
├── tsconfig.json              # TypeScript 配置文件
├── package.json               # npm 配置文件
└── README.md                  # 项目文档

安装

您可以使用 npm 全局安装 ZIP MCP 服务器：

npm install -g zip-mcp

MCP 配置

安装后，您可以在 MCP JSON 配置中配置 ZIP MCP：

{
  "mcpServers": {
    "zip-mcp": {
      "command": "zip-mcp",
      "args": []
    }
  }
}

在 AI 客户端中配置 MCP JSON

Claude Client: https://modelcontextprotocol.io/quickstart/user
Raycast: 需要安装 MCP 插件
Cursor: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

MCP 工具描述

ZIP MCP 服务器提供以下工具，可以通过 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)

返回输入的消息，以测试服务是否正常运行。

参数：

message: 要返回的消息

返回值：

包含输入消息和当前时间戳的文本内容

示例

使用 MCP 客户端调用工具的示例：

// 压缩文件
await client.executeTool("compress", {
  input: "/path/to/files/or/directory",
  output: "/path/to/output.zip",
  options: {
    level: 9,
    comment: "Test compression",
    password: "secret",
    overwrite: true,
  },
});

// 解压缩文件
await client.executeTool("decompress", {
  input: "/path/to/archive.zip",
  output: "/path/to/extract/directory",
  options: {
    password: "secret",
    overwrite: true,
    createDirectories: true,
  },
});

// 获取 ZIP 信息
await client.executeTool("getZipInfo", {
  input: "/path/to/archive.zip",
  options: {
    password: "secret",
  },
});

// 测试服务
await client.executeTool("echo", {
  message: "Hello, ZIP MCP Server!",
});