# mcp-npm-tools

MCP server providing npm and Node.js package management tools for AI agents.

## Tools

### npm_search
Search the npm registry for packages by keyword. Returns name, description, version, weekly downloads, and last publish date.

### npm_package_info
Get detailed information about a specific npm package: all published versions, dependencies, maintainers, repository URL, license, unpacked size, npm quality/popularity/maintenance scores, and weekly download count.

### npm_dependency_audit
Analyze a `package.json` file to find outdated dependencies (compares pinned/range version against latest), deprecated packages, and known security vulnerabilities via the npm bulk advisory API.

### npm_bundle_size
Estimate the bundle size of an npm package using the Bundlephobia API. Returns minified size, gzipped size, dependency count, and tree-shaking support indicators.

### npm_compare_packages
Compare two or more packages side by side across multiple dimensions: weekly downloads, bundle size, number of runtime dependencies, last publish date, GitHub stars, and license.

## Setup

```bash
npm install
npm run build
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "npm-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-npm-tools/dist/index.js"]
    }
  }
}
```

## Development

```bash
npm run build   # compile TypeScript
npm start       # run the server
```

## License

MIT