NPM Helper

A Model Context Protocol (MCP) server providing tools for NPM package management and dependency updates. Helps LLMs like Claude interact with npm packages, search npm registry, and keep dependencies up-to-date.

javascript

8

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pinkpixel-dev-npm-helper-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/npm-helper-mcp"
      ]
    }
  }
}

You can run and configure the npm-helper-mcp server to empower your LLM workflows with npm package management capabilities. It provides tools to search, update, and safely upgrade dependencies, helping keep projects up-to-date with compatibility in mind.

How to use

You will connect an MCP client to the npm-helper-mcp server and invoke its tools to inspect and upgrade your project’s dependencies. Start with a local test to scan for outdated packages, then selectively upgrade or apply constraints to upgrade safely. When you want a full upgrade, you can explore all available tools and parameters to navigate peer dependencies, conflicts, and version rules while keeping your project stable.

How to install

Prerequisites: install Node.js (version 18.x or later) and npm (version 8.x or later). Then choose one of the installation methods below.

{
  "mcpServers": {
    "npm_helper": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/npm-helper-mcp"
      ]
    }
  }
}

Option 2: Local installation

Install the package globally and run the server locally. Use these commands in sequence.

# Install the package globally
npm install -g npm-helper-mcp

# Run the server
npm-helper-mcp

Option 3: Install from source

If you prefer to build from source, clone the project, install dependencies, build, and start the server.

# Clone the repository
git clone https://github.com/pinkpixel-dev/npm-helper-mcp.git
cd npm-helper-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

{
  "mcpServers": {
    "npm_helper_src": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/npm-helper-mcp/dist/index.js"]
    }
  }
}

Available tools

check_updates

Scans package.json for outdated dependencies.

upgrade_packages

Upgrades dependencies to their latest versions.

filter_updates

Checks updates for specific packages.

resolve_conflicts

Handles dependency conflicts using peer dependencies.

set_version_constraints

Configures version upgrade rules.

run_doctor

Iteratively installs upgrades and runs tests to identify breaking upgrades.

search_npm

Searches npm packages.

fetch_package_content

Fetch and parse detailed content from an npm package page.

get_package_versions

Gets available versions for an npm package.

get_package_details

Gets detailed information about an npm package.