NPM MCP Server
This is a Model Context Protocol (MCP) server that provides functionality to fetch information about npm packages.
Features
- Package Search: Tool to fetch detailed information about npm packages
- Popular Packages: Resource to list the 10 most popular npm packages
Installation
Installing via Smithery
To install NPM MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @mateusribeirocampos/npm-mcp-server --client claude
Installing Manually
npm install
Build
npm run build
Running
npm start
For development:
npm run dev
Usage
The server exposes two main functionalities:
1. searchNpmPackage Tool
Fetches 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
- Dependencies list
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
Lists the 10 most popular npm packages, sorted by popularity. Each package in the list includes:
- Package name
- Description
- Current version
Resource URI: npm://popular
Example response:
[
{
"name": "lodash",
"description": "Lodash modular utilities",
"version": "4.17.21"
},
// ... more packages
]
Integration with AI Models
This MCP server can be integrated with AI models to:
- Get package information before installation
- Compare different package versions
- Analyze dependencies
- Find popular alternatives
- Get quick package summaries
Technologies
- TypeScript
- Model Context Protocol SDK
- Node-fetch
- Zod