zip

ZIP MCP Server implements the MCP (Model Context Protocol) to provide controllable ZIP compression, decompression, and metadata querying for ZIP archives. It exposes tools through the MCP interface: compress to create ZIP packages from files or folders with configurable level, password protection, and encryption; decompress to extract ZIP contents with optional password and overwrite controls; getZipInfo to retrieve detailed metadata about a ZIP file; and an echo tool for health checks. You can query these tools via the MCP client to perform batch or remote ZIP operations, making it suitable for automated workflows and integrations across editors, tooling, or scripted contexts.

Prerequisites:

• Node.js (recommended LTS) and npm installed on your system.
• Access to install global npm packages.

Install globally:

npm install -g zip-mcp

Verify installation:

zip-mcp --version

Configure MCP client to include the server:

• In your MCP JSON configuration, add:

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

Usage snippets:

• Compress: use the MCP client to invoke the compress tool with input, output, and options (level, password, encryptionStrength, overwrite).
• Decompress: specify input ZIP, output directory, and options (password, overwrite, createDirectories).
• Get ZIP info: provide input ZIP and optional password to retrieve metadata.
• Echo: test the service with a message.

Notes:

• Compression level ranges from 0-9 (default 5). Adjust for speed vs. size.
• If password protection is enabled, supply a password in both compress and corresponding decompress/getZipInfo calls.
• Overwrite controls determine whether existing files are replaced; enable with caution in automated workflows.
• Ensure paths provided to input/output are accessible by the server process. When using multi-file packaging, ensure all sources are included in the provided input array.
• If you encounter encoding or encryption issues, verify the environment supports the required crypto libraries and that the Node process has necessary permissions.