# zipnative MCP — ZIP creation, inspection, secure extraction & verification

> zipnative MCP — ZIP creation, inspection, secure extraction & verification is an open-source MCP server for files and documents. Local ZIP toolkit for MCP clients: create, inspect, verify and safely extract archives. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/nizoka/zipnative-mcp
- **MCP Registry name:** io.github.Nizoka/zipnative-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Fifteen tools handle ZIP work on a machine with no network access at all. The README stresses that the server has no network code path, no telemetry and never fetches a URL from an argument. It runs on the zero-dependency zipnative engine, which the README says is validated against ISO/IEC 21320-1 in CI, and ships seven prompts alongside the tools.

Extraction is secure by default: zip-slip and device names, symlinks, duplicate paths, size and ratio bombs and overlapping entries are refused with fixed ZIP_ error codes, and relaxations are explicit named inputs. File output is confined to one sandbox directory set by ZIPNATIVE_MCP_OUTPUT_DIR; if it is unset, every tool works on base64 only. Operators can also cap uncompressed size, entry counts, worker threads and file output size.

Beyond extraction, it can build reproducible archives, change one without recompressing anything, rewrite archives from Gradle, Maven or 7-Zip into a canonical deterministic form, and merge up to 32 sources. It installs from npm over stdio, with an optional loopback HTTP mode protected by a bearer token.

## Features

- **Secure extraction:** Refuses zip-slip, symlinks, duplicates and decompression bombs by default.
- **One-call inspection:** Reports sizes, counts, Zip64, encryption flags and a determinism verdict, and can act as a CI gate.
- **Reproducible creation:** Builds archives in canonical order with fixed timestamps, optionally byte-identical across runtimes.
- **Modify without recompressing:** Adds, replaces, removes or renames entries while keeping payloads untouched.
- **Merge and canonicalize:** Combines up to 32 archives or normalises one into a deterministic form.
- **Truncated-stream scanning:** Walks local headers to list entries from a cut-off download.
- **Sandboxed file output:** Writes only inside one configured directory and rejects planted symlinks.

## Good for

- Check an untrusted ZIP for traversal or bomb risks before extracting
- Make build artifacts reproducible for CI comparison
- Read a single file from a large archive without unpacking it
- Merge several archives without recompression
- Recover an entry listing from a partially downloaded ZIP

## Install

### Claude Code (Terminal)

```sh
claude mcp add zipnative-mcp --env ZIPNATIVE_MCP_HTTP_TOKEN='<ZIPNATIVE_MCP_HTTP_TOKEN>' -- npx -y zipnative-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zipnative-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zipnative-mcp"
      ],
      "env": {
        "ZIPNATIVE_MCP_HTTP_TOKEN": "<ZIPNATIVE_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zipnative-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zipnative-mcp"
      ],
      "env": {
        "ZIPNATIVE_MCP_HTTP_TOKEN": "<ZIPNATIVE_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zipnative-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zipnative-mcp"
      ],
      "env": {
        "ZIPNATIVE_MCP_HTTP_TOKEN": "<ZIPNATIVE_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zipnative-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zipnative-mcp"
      ],
      "env": {
        "ZIPNATIVE_MCP_HTTP_TOKEN": "<ZIPNATIVE_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zipnative-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zipnative-mcp"
      ],
      "env": {
        "ZIPNATIVE_MCP_HTTP_TOKEN": "<ZIPNATIVE_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `inspect_zip`: One-call archive report with sizes, counts, flags and a determinism verdict.
- `list_zip_entries`: Paged central-directory inventory without decompressing.
- `read_zip_entry`: Reads one entry by name or index without extracting.
- `verify_zip`: Deep verification of structure, CRC-32 and sizes.
- `extract_zip`: Secure-by-default extraction inline or into the sandbox.
- `scan_zip_forward`: Walks local headers of truncated or unseekable streams.
- `sanitize_entry_paths`: Maps names to safe relative paths or reports the rule that fired.
- `create_zip`: Writes a ZIP from inline text, base64 or sandbox files.
- `modify_zip`: Adds, replaces, removes or renames entries without recompressing.
- `canonicalize_zip`: Rewrites an archive into canonical deterministic form.
- `merge_zip`: Merges 1 to 32 archives without recompressing.
- `compute_crc32`: Computes the ZIP CRC-32 of text, base64 or a file.
- `inflate_raw`: Raw DEFLATE decompression with a mandatory output bound.
- `describe_engine`: Offline report of versions, limits, codecs and error codes.
- `draft_governance_issue`: Drafts a GitHub issue locally for a human to submit.

## FAQ

### Does it make network requests?

No. The README says there is no network code path, no telemetry and no URL fetching.

### Where can it write files?

Only under the directory named by ZIPNATIVE_MCP_OUTPUT_DIR; without it, tools work on base64 only.

### How many tools does it have?

Fifteen, including inspect_zip, extract_zip, create_zip, merge_zip and verify_zip.

### Can it run over HTTP?

Yes, on a loopback port via ZIPNATIVE_MCP_PORT; setting ZIPNATIVE_MCP_HTTP_TOKEN requires a bearer token.

### Is zipnative MCP — ZIP creation, inspection, secure extraction & verification free?

Yes. zipnative MCP — ZIP creation, inspection, secure extraction & verification is open source, so you can use and self-host it for free.

### How do I add zipnative MCP — ZIP creation, inspection, secure extraction & verification to Claude Code?

Run this command in your terminal: claude mcp add zipnative-mcp --env ZIPNATIVE_MCP_HTTP_TOKEN='<ZIPNATIVE_MCP_HTTP_TOKEN>' -- npx -y zipnative-mcp

### What are the best alternatives to zipnative MCP — ZIP creation, inspection, secure extraction & verification?

The closest alternatives to zipnative MCP — ZIP creation, inspection, secure extraction & verification are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/zipnative-mcp-zip-creation-inspection-secure-extraction-and
