NPM Package Search

🚀 NPM MCP Server

This is a Model Context Protocol (MCP) server that provides query functionality for npm package information.

🚀 Quick Start

This server offers two main functions: searching for specific npm packages and listing the top 10 popular npm packages. You can install, build, and run the server following the steps below.

✨ Features

1. Package Search: Retrieve detailed information about specific npm packages.
2. Popular Packages: List the top 10 most popular npm packages.

📦 Installation

Install via Smithery

Automatically install the NPM MCP Server to Claude Desktop through Smithery:

npx -y @smithery/cli install @mateusribeirocampos/npm-mcp-server --client claude

Manual Installation

npm install

Build

npm run build

Run

npm start

In development mode:

npm run dev

💻 Usage Examples

Basic Usage

The server mainly provides the following two functions:

1. searchNpmPackage Tool

Retrieve detailed information about a specific npm package. This tool returns comprehensive package information, including:

• Package name
• Latest version
• Description
• Author information
• Homepage URL
• Repository URL
• List of dependencies

Example usage:

const result = await server.tools.searchNpmPackage({ packageName: "react" });

Example response:

{
  "name": "react",
  "version": "18.2.0",
  "description": "React is a JavaScript library for building user interfaces.",
  "author": "Meta Open Source",
  "homepage": "https://reactjs.org/",
  "repository": {
    "url": "https://github.com/facebook/react.git"
  },
  "dependencies": {
    "loose-envify": "^1.1.0"
  }
}

2. popular-packages Resource

List the top 10 most popular npm packages, sorted by popularity. Information for each package includes:

• Package name
• Description
• Current version

Resource URI: npm://popular

Example response:

[
  {
    "name": "lodash",
    "description": "Lodash modular utility collection",
    "version": "4.17.21"
  },
  // ... More packages
]

📚 Documentation

Integration with AI Models

This MCP server can be integrated with AI models for:

1. Obtaining package information before installation
2. Comparing different versions of packages
3. Analyzing dependencies
4. Finding popular alternatives
5. Getting quick package summaries

🔧 Technical Details

• TypeScript
• Model Context Protocol SDK
• Node-fetch
• Zod