ZIP MCP Server

by 7gugu

16 stars

513 downloads

Not rated

GitHub Website

About

Enables direct file compression and decompression operations using ZIP format through fastMCP and zip.js utilities for efficient file handling within conversations.

Details

Author: 7gugu
GitHub stars: 16
Downloads: 513
Categories: File Management, Other, Productivity, Developer Tools, Design, AI, Infrastructure

- Supports compression and decompression of files and data
- Supports multi-file packaging compression
- Provides compression level control (0-9)
- Supports password protection and encryption strength settings
- Provides query function for compressed package metadata
- Validates ZIP entry paths on decompression to prevent path traversal writes

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name ZIP MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

From the repository

You can install ZIP MCP Server globally using npm:

npm install -g zip-mcp

After installation, you can configure ZIP MCP in your MCP JSON configuration:

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

- Claude Client: https://modelcontextprotocol.io/quickstart/user
- Raycast: requires installing the MCP plugin
- Cursor: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "zip mcp server": {
            "zip-mcp": {
                "command": "npx",
                "args": [
                    "tsx",
                    "<ABSOLUTE PATH>/src/index.ts"
                ]
            }
        }
    }
}

McpServers

{
    "zip-mcp": {
        "command": "npx",
        "args": [
            "tsx",
            "<ABSOLUTE PATH>/src/index.ts"
        ]
    }
}

ZIP MCP Server is a compression server based on fastMCP and zip.js, implementing the Model Context Protocol (MCP). This project provides fully parameter-controlled ZIP compression, decompression, and query compression package information functions.

Versions1.0.6and later fix an arbitrary file write issue in thedecompresstool: malicious ZIP entry names (for example../outside.txt) could previously be joined with the output directory and written outside the intended extraction root. Extraction now resolves the output root once, validates each entry path, and rejects absolute paths, drive-letter paths,..segments, and any path that would escape the output directory.

Thanks toRyan(vonbrubeck@gmail.com) for responsibly reporting this issue.

zip-mcp ├── src │ ├── index.ts # Application entry point │ ├── utils │ │ ├── compression.ts # Compression and decompression implementation │ │ └── safePath.ts # Safe ZIP entry path validation ├── tsconfig.json # TypeScript configuration file ├── package.json # npm configuration file └── README.md # Project documentation

You can install ZIP MCP Server globally using npm:

After installation, you can configure ZIP MCP in your MCP JSON configuration:

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

- Claude Client:https://modelcontextprotocol.io/quickstart/user
- Raycast: requires installing the MCP plugin
- Cursor:https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

ZIP MCP Server provides the following tools, which can be called through the MCP protocol:

Compress local files or directories into a ZIP file.

- input: Path of the file or directory to be compressed (string or string array)
- output: Path of the output ZIP file
- options: Compression options (optional)

- level: Compression level (0-9, default is 5)
- password: Password protection
- encryptionStrength: Encryption strength (1-3)
- overwrite: Whether to overwrite existing files (boolean)

- Success: Text content containing success information
- Failure: Text content containing error information

Decompress local ZIP files to the specified directory. Entry paths are validated before writing so files cannot be extracted outsideoutputvia..or absolute paths.

- input: Path of the ZIP file
- output: Path of the output directory
- options: Decompression options (optional)

- password: Decompression password
- overwrite: Whether to overwrite existing files (boolean)
- createDirectories: Whether to create non-existent directories (boolean)

- Success: Text content containing decompression result information
- Failure: Text content containing error information

Get metadata information of local ZIP files.

- input: Path of the ZIP file
- options: Options (optional)

- password: Decompression password

- Success: Text content containing detailed information of the ZIP file, including:

- Total number of files
- Total size
- Compressed size
- Compression ratio
- Detailed information of each file

Returns the input message to test if the service is running normally.

- Text content containing the input message and current timestamp

Examples of calling tools using the MCP client:

// Compress files 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, }, }); // Decompress files await client.executeTool("decompress", { input: "/path/to/archive.zip", output: "/path/to/extract/directory", options: { password: "secret", overwrite: true, createDirectories: true, }, }); // Get ZIP info await client.executeTool("getZipInfo", { input: "/path/to/archive.zip", options: { password: "secret", }, }); // Test service await client.executeTool("echo", { message: "Hello, ZIP MCP Server!", });

- Email:gz7gugu@qq.com
- Blog:https://7gugu.com

Parses various file formats using the 302.AI API, requiring a 302AI_API_KEY.

A local server that allows AI to execute Windows CMD commands, read/write files, and manage directories within a specified path.

Filesystem agent memory working with consolidation Daemon on your machine

An AI-powered MCP server for advanced file system operations, including search, comparison, and security analysis.

Securely browse and read files within an Android project, with built-in validation and access controls for sensitive directories.

Build a persistent, local knowledge base in Markdown files through conversations with LLMs.

A read-only MCP server for querying live FTP data using the CData JDBC Driver.

An MCP server for viewing, editing, and creating text files, based on the Claude built-in text editor tool.

Convert PDF, Word, Excel, PowerPoint, EPUB, HEIC and images from Claude or Cursor, with 35 converters exposed through just two MCP tools.

A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

ZIP MCP Server

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀