npm-search MCP Server

What is npm-search MCP Server?

npm-search MCP Server is a Model Context Protocol server that searches npm packages by wrapping the npm search command. It is intended for AI assistants that need to query the npm registry for package information.

How to use npm-search MCP Server?

Install globally via npm install -g npm-search-mcp-server and run npm-search-mcp-server, or use uvx npm-search-mcp-server directly. Configure your MCP client (e.g. Claude.app, Zed) with the command npx -y npm-search-mcp-server or uvx npm-search-mcp-server. The server provides a single tool search_npm_packages that requires a query string argument.

Key features of npm-search MCP Server

• 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.

Use cases of npm-search MCP Server

• Find npm packages by keyword during AI-assisted development.
• Retrieve package metadata (name, description, version, author, license) for a query.
• Integrate npm search capabilities into MCP-compatible IDEs or chat assistants.

FAQ from npm-search MCP Server

What tool does npm-search MCP Server expose?

It exposes the search_npm_packages tool.

What arguments does search_npm_packages require?

The only required argument is query (a string representing the search term).

How can I run npm-search MCP Server in HTTP mode?

Set the PORT environment variable (e.g., PORT=3009) and start the server. HTTP endpoints include POST /mcp, GET /mcp, DELETE /mcp, and GET /health.

How do I debug the server?

You can use the MCP inspector: run npx @modelcontextprotocol/inspector npx -y npm-search-mcp-server.

What transport modes are supported?

The server supports stdio transport by default and HTTP (streamable-http) transport when a PORT variable is defined.