About npm-search-mcp
npm-search-mcp is an MCP server that provides AI coding assistants with current npm registry information. It searches packages, retrieves package details, and compares alternatives without requiring an API key.
Key features
- 01Search packages by keyword
- 02Retrieve version and dependency details
- 03View package size and download counts
- 04Compare 2–10 packages
Use cases
- 01Find npm packages for a development task
- 02Check a package's current version and dependencies
- 03Compare candidate packages by downloads and size
MCP support
It exposes npm search, package detail, and comparison tools to MCP clients using live registry data. No API key is needed.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
docker run -i --rm ghcr.io/zcag/npm-search-mcp:1.0.0Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
ghcr.io/zcag/npm-search-mcp:1.0.0stdioTools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEnpm-search-mcp
MCP server that searches npm packages and returns live registry data. No API key needed.
Tools
- search_packages — Search npm for packages by keyword. Returns names, descriptions, download counts, and links.
- get_package — Get detailed info about a specific package: version, dependencies, size, weekly downloads.
- compare_packages — Compare 2-10 packages side by side with download stats, size, and quality scores.
Why?
AI coding assistants have stale knowledge about npm packages. This MCP server gives them live access to the npm registry — current versions, download trends, and package details updated in real-time.
Install
npx (easiest)
npx -y github:zcag/npm-search-mcp
Claude Code config
{
"mcpServers": {
"npm-search": {
"command": "npx",
"args": ["-y", "github:zcag/npm-search-mcp"]
}
}
}
Docker
docker run -i ghcr.io/zcag/npm-search-mcp:1.0.0
From source
git clone https://github.com/zcag/npm-search-mcp.git
cd npm-search-mcp
npm install && npm run build
node dist/index.js
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.