Zip MCP

🚀 ZIP MCP 服務器

ZIP MCP 服務器是基於 fastMCP 和 zip.js 實現的 Model Context Protocol (MCP) 壓縮服務器，能提供完全參數控制的 ZIP 文件壓縮、解壓以及查詢壓縮包信息功能，極大地方便了文件處理。

🚀 快速開始

安裝說明

使用 npm 全局安裝 ZIP MCP Server：

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

✨ 主要特性

• 支持文件和數據的壓縮與解壓
• 支持多文件打包壓縮
• 提供壓縮級別控制（0 - 9）
• 支持密碼保護及加密強度設置
• 提供查詢壓縮包元數據的功能

📦 項目結構

zip-mcp
├── src
│   ├── index.ts               # 應用入口文件
│   ├── utils
│   │   └── compression.ts     # 壓縮與解壓實現文件
├── tsconfig.json              # TypeScript 配置文件
├── package.json               # npm 配置文件
└── README.md                  # 項目文檔

💻 使用示例

基礎用法

// 壓縮示例
await client.executeTool("zip-mcp/compress", {
  input: ["./files/to_compress/*"],
  output: "./compressed.zip",
  options: {
    level: 9,
    password: "yourpassword"
  }
});

// 解壓示例
await client.executeTool("zip-mcp/decompress", {
  input: "./compressed.zip",
  output: "./extracted_files",
  options: {
    password: "yourpassword"
  }
});

// 查詢示例
await client.executeTool("zip-mcp/query", {
  input: "./compressed.zip",
  options: {
    password: "yourpassword"
  }
});

📚 詳細文檔

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: 是否創建子目錄（布爾值）

返回：

• 成功：包含成功信息的文本內容
• 失敗：包含錯誤信息的文本內容

查詢工具（query）

查詢壓縮包內的文件列表。

參數：

• input: 待查詢的 ZIP 文件路徑
• options: 查詢選項（可選）
  • password: 解密密碼（如果需要解密）

返回：

• 成功：包含文件列表的文本內容
• 失敗：包含錯誤信息的文本內容

📄 聯繫方式

• 郵箱：gz7gugu@qq.com
• 博客：https://7gugu.com