ZIP MCP Server

The ZIP MCP Server acts as a digital packing assistant for AI models, allowing them to manage compressed files just like a human would. This tool gives AI assistants the ability to create new ZIP archives, open existing ones, and see exactly what's inside a folder without having to extract everything first. It is perfect for users who want their AI to help organize cluttered directories or bundle a batch of documents for easy sharing. Moving beyond basic file management, this server provides a robust set of parameters for fine-tuned control over archives. It supports multi-file packaging and offers specific controls for compression levels ranging from 0 to 9. For users handling sensitive information, the tool includes advanced security features such as password protection and adjustable encryption strength, ensuring that the AI can handle secure data workflows while maintaining file integrity. For developers integrating with LLM systems like Claude or Cursor, this MCP tool bridges the gap between high-level reasoning and low-level file system operations. By using the metadata retrieval tool, an AI can analyze the structure, compression ratio, and file sizes of an archive before deciding how to process the contents. This makes it an essential utility for building automated workflows where an AI must manage local storage, handle large datasets, or package software assets efficiently through a standardized protocol.

Category: Developer Tools & Code Intelligence

Tags: archiving, compression, encryption, file-management, zip

Visit ZIP MCP Server

How to install and configure ZIP MCP Server

1. Installation You can install the ZIP MCP Server globally using npm: bash npm install -g zip-mcp

2. Configuration To use the ZIP MCP Server in your MCP-compatible AI client (such as Claude Desktop or Cursor), add the following to your mcpServers configuration JSON: json { "mcpServers": { "zip-mcp": { "command": "zip-mcp", "args": [] } } }

3. Available Tools The ZIP MCP Server provides the following tools for file management: * compress: Compresses local files or directories into a ZIP file. * Parameters: * input (string or string array): Path of the file or directory to be compressed. * output (string): Path of the output ZIP file. * options (optional): level (0-9), password, encryptionStrength (1-3), overwrite (boolean). * decompress: Decompresses local ZIP files to a specified directory. * Parameters: * input (string): Path of the ZIP file. * output (string): Path of the output directory. * options (optional): password, overwrite (boolean), createDirectories (boolean). * getZipInfo: Retrieves metadata from local ZIP files. * Parameters: * input (string): Path of the ZIP file. * options (optional): password. * echo: A test tool to verify if the service is running correctly. * Parameters: * message (string): The message to be returned.

4. Usage Examples Compressing files with a password: "Compress the folder at /path/to/files into a ZIP file named output.zip with a compression level of 9 and set the password to 'secret'." Decompressing an archive: "Extract all files from archive.zip to the directory /path/to/extract, ensuring that any existing files are overwritten." Checking ZIP contents: "Show me the metadata and file list for the ZIP file located at /path/to/archive.zip." Testing the server: "Send an echo message 'Hello ZIP MCP' to verify the server is active."

What you can do with ZIP MCP Server

Use Case 1: Automated Project Archiving for Distribution Problem: Developers frequently need to package specific project files (like source code, documentation, and configuration) for a release or to share a bug reproduction with a colleague. Manually selecting files and running terminal commands is a context switch that interrupts the workflow. Solution: The AI can use the compress tool to identify relevant files and bundle them into a single ZIP file with a high compression level (9). It can even exclude unnecessary folders like node_modules or .git by only selecting the necessary input paths. Example: "Claude, please bundle all the .ts files in my src folder and the README.md into a file named v1-alpha-release.zip using the highest compression level."

Use Case 2: Securely Sharing Sensitive Logs or Data Problem: When troubleshooting, developers may need to send log files or database exports that contain sensitive information. Sending these files as plain text is a security risk. Solution: The ZIP MCP Server allows for password protection and varying levels of encryption strength. The AI can be instructed to compress sensitive assets and apply a secure password before the user uploads the file to a shared drive or messaging platform. Example: "I need to send these server logs to the security team. Compress the `logs

error-logsdirectory intosecure-logs.zip`, set the encryption strength to 3, and use a strong random password."

Use Case 3: Pre-Extraction Archive Inspection Problem: Users often download ZIP files from the internet and are unsure of their exact contents or size. Extracting a massive or nested archive without knowing what’s inside can clutter the local file system or trigger security concerns. Solution: Using the getZipInfo tool, the AI can "peek" inside the archive to list the total number of files, the compression ratio, and the specific file names and sizes without actually decompressing the file. Example: "I just downloaded dataset.zip. Before I extract it, tell me what files are inside, how big they are, and if the compression ratio suggests it contains mostly text or binary data."

Use Case 4: Automated Workspace Cleanup and Log Rotation Problem: Local development environments often become cluttered with old log files, build artifacts, and temporary data that take up significant disk space but shouldn't be deleted permanently. Solution: The AI can act as a maintenance assistant. It can identify files older than a certain date, use the compress tool to archive…

Key facts

  • https://github.com/7gugu/zip-mcp
  • Developer Tools & Code Intelligence, Files, Documents & PDFs
  • archiving, compression, encryption, file-management, zip

Part of MCP Servers

Related MCP servers

  • MCP LaTeX Server — MCP LaTeX Server is an MCP server that provides tools for creating, editing, validating, and compiling LaTeX documents directly through…
  • MCP JSON — MCP JSON is an MCP server collection that bundles tools for file system operations, Google search, browser-based web automation, and…
  • MCP Jupyter Complete — MCP Jupyter Complete is an MCP server that provides tools for manipulating Jupyter notebook files through position-based cell operations and…
  • MCP LSP Go — MCP LSP Go is an MCP server that connects AI assistants to the official Go Language Server Protocol implementation, gopls,…
  • MCP Manager — MCP Manager is an MCP server management tool that connects directly to your Claude Desktop environment, enabling users to discover,…
  • MCP MD2PDF Server — MCP MD2PDF Server is an MCP server that enables automated conversion of Markdown documents into formatted PDF files with full…

What can ZIP MCP Server do?

ZIP MCP Server allows AI assistants to compress files or directories, extract existing ZIP archives, and retrieve detailed metadata without extracting files. It supports multi-file selection, compression levels from 0 to 9, password protection, and custom encryption strength settings.

How do I install ZIP MCP Server?

You install it globally on your machine using the Node Package Manager by running npm install -g zip-mcp. Once installed, add the zip-mcp command to the mcpServers configuration object of your preferred MCP client.

Which MCP clients work with ZIP MCP Server?

ZIP MCP Server is compatible with any tool implementing the Model Context Protocol. Supported clients explicitly documented include Claude Client, Cursor, and Raycast when configured with the MCP plugin.

Does ZIP MCP Server protect against zip slip vulnerabilities?

Yes. Starting in version 1.0.6, the decompression tool validates each entry path. It rejects absolute paths, drive-letter specifications, and dot-dot segments to prevent malicious archives from writing files outside the intended destination directory.

  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories