Mateusribeirocampos Npm MCP Server

🚀 NPM MCP Server

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

🚀 Quick Start

This server offers query services for npm package information. You can install and run it according to the following steps to start using it.

✨ 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 for 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

Development mode:

npm run dev

💻 Usage Examples

Basic Usage

The server provides two main functions:

1. searchNpmPackage Tool

Retrieve detailed information about a specific npm package. The 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 Projects",
  "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
]

🔧 Technical Details

Integration with AI Models

This MCP server can be used in conjunction with AI models for:

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

Technology Stack

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

📄 License

No license information provided in the original document.

⚠️ Important Note

The above content is based on the original README document and has been translated and beautified. For the latest and most accurate information, please refer to the official repository.

💡 Usage Tip

When using the searchNpmPackage tool, ensure that the entered package name is accurate to obtain correct package information.