# npm pack checker (what npm publish ships)

> npm pack checker (what npm publish ships) is an open-source MCP server for developer tools. Shows exactly which files npm publish ships and the rule behind each one. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/lawatch/10aday/tree/HEAD/products/mcp/npm-pack-check
- **MCP Registry name:** io.github.Lawatch/npm-pack-check
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-19

## About

The README says it reproduces the file list npm 10 produces for a tarball, so you can see what would be published before running npm publish and without touching the registry. For every path it reports whether it ships and which rule decides, whether that is a .npmignore or .gitignore line, a files entry, or npm's built-in defaults.

Beyond the listing, it flags common packaging mistakes: secrets such as .env or keys that would be published because a .npmignore replaced a .gitignore, entries in files or main and bin that will not ship, and tests or coverage output that slipped in. The README describes the engine as a port of npm-packlist and ignore-walk, checked against npm's own output on many generated projects.

It is aimed at Node package maintainers and at AI assistants that prepare packages for release. It runs as a local stdio server, is offline and read-only, and is published under the MIT license.

## Features

- **Exact tarball file list:** Reproduces the same files and order as npm pack --dry-run from a list of paths and ignore files.
- **Rule attribution per path:** Explains whether each path ships and which .npmignore, .gitignore, files entry or built-in rule decided it.
- **Secret leak warnings:** Warns when sensitive files such as .env or keys would be published.
- **Missing entry point checks:** Flags main, bin, browser or types targets that will not ship, and files entries that match nothing.
- **Offline and read-only:** Runs locally over stdio without file access or publishing to the registry.

## Good for

- Check a package for leaked secrets before running npm publish
- Understand why a particular file is or is not in the published tarball
- Catch a main or bin entry point that would break installs for users
- Give an AI coding assistant a reliable packaging check before release

## Install

### Claude Code (Terminal)

```sh
claude mcp add npm-pack-check -- docker run -i --rm ghcr.io/lawatch/npm-pack-check:1.0.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "npm-pack-check": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/lawatch/npm-pack-check:1.0.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "npm-pack-check": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/lawatch/npm-pack-check:1.0.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "npm-pack-check": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/lawatch/npm-pack-check:1.0.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "npm-pack-check": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/lawatch/npm-pack-check:1.0.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "npm-pack-check": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/lawatch/npm-pack-check:1.0.0"
      ]
    }
  }
}
```

## Tools

- `check_npm_pack`: Returns the exact file list of the npm tarball with warnings for secrets, ignore-file conflicts and missing entry points.
- `why_npm_pack`: For each path, states whether it ships and the exact rule that decides it.

## FAQ

### Does it publish anything to npm?

No. The README states it is offline, read-only, and that nothing is published.

### How do I install it?

The README lists a Claude Desktop .mcpb file from the GitHub release, a Docker image run over stdio, or running server.js from source with Node 18+.

### Which license does it use?

The README says it is released under the MIT license.

### What is not modelled?

The README says files added from bundleDependencies are not modelled, and symlinks are not included because npm never ships them.

### Is npm pack checker (what npm publish ships) free?

Yes. npm pack checker (what npm publish ships) is open source, so you can use and self-host it for free.

### How do I add npm pack checker (what npm publish ships) to Claude Code?

Run this command in your terminal: claude mcp add npm-pack-check -- docker run -i --rm ghcr.io/lawatch/npm-pack-check:1.0.0

### What are the best alternatives to npm pack checker (what npm publish ships)?

The closest alternatives to npm pack checker (what npm publish ships) are npm why (who installs this package), npm Registry MCP Server, package.json exports resolver (which file Node loads), unripe and Notary.

## Where this comes from

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

## Alternatives

- [npm why (who installs this package)](https://ai-powered.com/mcp/npm-why-who-installs-this-package): npm why (who installs this package) is an open-source MCP server for developer tools.
- [npm Registry MCP Server](https://ai-powered.com/mcp/npm-registry-mcp-server): npm Registry MCP Server is an open-source MCP server for developer tools.
- [package.json exports resolver (which file Node loads)](https://ai-powered.com/mcp/package-json-exports-resolver-which-file-node-loads): package.json exports resolver (which file Node loads) is an open-source MCP server for developer tools.
- [unripe](https://ai-powered.com/mcp/unripe-2): unripe is an open-source MCP server for security.
- [Notary](https://ai-powered.com/mcp/notary): Notary is a free MCP server for security.
- [Proofpack](https://ai-powered.com/mcp/proofpack): Proofpack is an open-source MCP server for developer tools.
- [Dockerignore checker (exact Docker rules)](https://ai-powered.com/mcp/dockerignore-checker-exact-docker-rules): Dockerignore checker (exact Docker rules) is an open-source MCP server for developer tools.
- [npx-vibe](https://ai-powered.com/mcp/npx-vibe): npx-vibe is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/npm-pack-checker-what-npm-publish-ships
