NPM Search
About
Enables npm package searches via CLI, facilitating JavaScript library discovery and dependency management
Details
- Author
- btwiuse
- Repository
- btwiuse/npm-search-mcp-server
- GitHub stars
- 14
- Downloads
- 1,492
- License
- MIT License
- Categories
- Search, Community, Other, AI, Design, Infrastructure, Developer Tools
- Tags
- #mobile
Jump to
- Search npm packages using the npm search command.
- Supports both stdio and HTTP (streamable-http) transport modes.
- HTTP mode automatically enabled when PORT environment variable is set.
- Structured logging with Pino and graceful shutdown.
- Health check endpoint (/health) and session management for HTTP transport.
- Docker support with HTTP transport on port 3009.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
NPM SearchCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
npm-search-mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install npm-search for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install npm-search-mcp-server --client claude
Add to your Claude settings:
<details>
<summary>Using npm installation</summary>
"mcpServers": {
"npm-search": {
"command": "npx",
"args": ["-y", "npm-search-mcp-server"]
}
}
<details>
<summary>Using uvx</summary>
"mcpServers": {
"npm-search": {
"command": "uvx",
"args": ["npm-search-mcp-server"]
}
}
Add to your Zed settings.json:
<details>
<summary>Using npm installation</summary>
"context_servers": {
"npm-search-mcp-server": {
"command": "npx",
"args": ["-y", "npm-search-mcp-server"]
}
},
<details>
<summary>Using uvx</summary>
"context_servers": [
"npm-search-mcp-server": {
"command": "uvx",
"args": ["npm-search-mcp-server"]
}
],
search_npm_packages
Search for npm packages. Required arguments: query (string): The search query.
- search_npm_packages - Search for npm packages.
- Required arguments:
- query (string): The search query.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"npm search": {
"env": {},
"args": [
"-y",
"npm-search-mcp-server"
],
"command": "npx"
}
}
}Linux
{
"env": [],
"args": [
"-y",
"npm-search-mcp-server"
],
"command": "npx"
}Macos
{
"env": [],
"args": [
"-y",
"npm-search-mcp-server"
],
"command": "npx"
}Windows
{
"env": [],
"args": [
"/c",
"npx",
"-y",
"npm-search-mcp-server"
],
"command": "cmd"
}- Search npm packages using thenpm searchcommand
- Supports both stdio and HTTP (streamable-http) transport modes
- HTTP mode automatically enabled whenPORTenvironment variable is set
- Structured logging with Pino
- Graceful shutdown handling
- Health check endpoint (/health)
- Session management for HTTP transport
- search_npm_packages- Search for npm packages.
- Required arguments:
- query(string): The search query.
To install npm-search for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install npm-search-mcp-server --client claude
Alternatively you can installnpm-search-mcp-servervia npm:
After installation, you can run it as a command using:
When usinguvno specific installation is needed. We will useuvxto directly runnpm-search-mcp-server.
"mcpServers": { "npm-search": { "command": "npx", "args": ["-y", "npm-search-mcp-server"] } }
"mcpServers": { "npm-search": { "command": "uvx", "args": ["npm-search-mcp-server"] } }
"context_servers": { "npm-search-mcp-server": { "command": "npx", "args": ["-y", "npm-search-mcp-server"] } },
"context_servers": [ "npm-search-mcp-server": { "command": "uvx", "args": ["npm-search-mcp-server"] } ],
{ "name": "search_npm_packages", "arguments": { "query": "express" } }
{ "results": [ { "name": "express", "description": "Fast, unopinionated, minimalist web framework", "version": "4.17.1", "author": "TJ Holowaychuk", "license": "MIT" }, ... ] }
You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector npx -y npm-search-mcp-server
Or if you've installed the package in a specific directory or are developing on it:
cd path/to/servers/src/npm-search npx @modelcontextprotocol/inspector uv run npm-search-mcp-server
- "Search for express package on npm"
- "Find packages related to react"
- "Show me npm packages for web development"
The server can be run in a Docker container with HTTP transport support:
# Build the image docker build -t mcp/npm-search . # Run the container (default port 3009) docker run -p 3009:3009 mcp/npm-search # Run with custom port via environment variable docker run -p 3009:3009 -e PORT=3009 mcp/npm-search
The Docker image uses HTTP transport when thePORTenvironment variable is set. The server exposes:
- POST /mcp- Main MCP endpoint for tool calls and session initialization
- GET /mcp- SSE stream endpoint for streaming responses (requires session ID)
- DELETE /mcp- Session termination endpoint
- GET /health- Health check endpoint with service status and active session count
services: npm-search-mcp: build: . ports: - "3009:3009" environment: PORT: 3009
We encourage contributions to help expand and improve npm-search-mcp-server. Whether you want to add new npm-related tools, enhance existing functionality, or improve documentation, your input is valuable.
For examples of other MCP servers and implementation patterns, see:https://github.com/modelcontextprotocol/servers
Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make npm-search-mcp-server even more powerful and useful.
npm-search-mcp-server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Search for IP addresses using Chaitin's IP Intelligence API.
Get any answer from the Facebook Ads Library, conduct deep research including messaging, creative testing and comparisons in seconds.
Google News search capabilities with automatic topic categorization and multi-language support via SerpAPI integration.
A Model Context Protocol (MCP) server providing access to Google Programmable Search Engine (PSE) and Custom Search Engine (CSE).
A Model Context Protocol (MCP) server providing access to Google Search Console.
A Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book and author information.
An enhanced MCP server for SearXNG web searching, utilizing a category-aware web-search, web-scraping, and includes a date/time retrieval tool.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
