zip-mcp

loscolmebrothers/zip-mcp

3.2

If you are the rightful owner of zip-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The ZIP MCP Server is a Model Context Protocol server that provides ZIP file compression and decompression capabilities for AI assistants like Claude.

Tools
4
Resources
0
Prompts
0

ZIP MCP Server

npm version

npm downloads

View @loscolmebrothers/zip-mcp on npm

An MCP (Model Context Protocol) server that provides ZIP file compression and decompression capabilities for AI assistants like Claude.

Features

  • Compress files and directories into ZIP archives
  • Decompress ZIP files to specified directories
  • Get ZIP metadata including file listings and compression info
  • Support for multiple input files/directories
  • Configurable compression options
  • Password protection support (via adm-zip)

Installation

npm install
npm run build

Usage

As an MCP Server

Add to your Claude Desktop configuration file:

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"]
    }
  }
}

Available Tools

compress

Compress local files or directories into a ZIP file.

Parameters:

  • input (string | string[]): File path(s) or directory to compress
  • output (string): Output ZIP file path
  • options (optional):
    • overwrite (boolean): Overwrite if output file exists
    • level (number): Compression level (0-9)
    • password (string): Password to encrypt ZIP file
    • comment (string): ZIP file comment
    • encryptionStrength (number): Encryption strength (1=AES-128, 2=AES-192, 3=AES-256)

Example:

{
  "input": ["./docs", "./src/index.ts"],
  "output": "./archive.zip",
  "options": {
    "overwrite": true,
    "comment": "Project backup"
  }
}
decompress

Decompress a local ZIP file to a specified directory.

Parameters:

  • input (string): ZIP file path to decompress
  • output (string): Output directory path
  • options (optional):
    • overwrite (boolean): Overwrite existing files
    • password (string): Password for encrypted ZIP
    • createDirectories (boolean): Create output directory if it doesn't exist

Example:

{
  "input": "./archive.zip",
  "output": "./extracted",
  "options": {
    "overwrite": true,
    "createDirectories": true
  }
}
getZipInfo

Get metadata information about a ZIP file.

Parameters:

  • input (string): ZIP file path
  • options (optional):
    • password (string): Password for encrypted ZIP

Returns: JSON with file size, entry count, file listings, and compression details.

echo

Simple echo tool for testing the MCP connection.

Parameters:

  • message (string): Message to echo back

Development

# Install dependencies
npm install

# Build the project
npm run build

# The build output will be in ./build/index.js

Dependencies

License

ISC

Author

danicolms