npm-search MCP Server

by MCP-Mirror

359 downloads
Not rated
GitHub

About

It is a Model Context Protocol server that enables searching npm packages by invoking the npm search command. Designed for developers using MCP-compatible assistants like Claude.

Details

Author
MCP-Mirror
Downloads
359
Categories
Search

- Provides a single search_npm_packages tool.
- Required argument: query (string).
- Returns package name, description, version, author, and license.
- Installable via npm, npx, or uvx.
- Works with Claude.app, Zed, and other MCP clients.

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name npm-search MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install globally via npm (npm install -g npm-search-mcp-server) or run via npx or uvx. Configure it in your MCP client (e.g., Claude.app or Zed) using the provided JSON settings. Invoke the search_npm_packages tool with a query string argument to search for packages.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "npm-search mcp server": {
            "btwiuse_npm-search-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "npm-search-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "btwiuse_npm-search-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "npm-search-mcp-server",
            "--client",
            "claude"
        ]
    }
}

npm-search MCP Server

smithery badge

A Model Context Protocol server that allows you to search for npm packages by calling the npm search command.

<a href="https://glama.ai/mcp/servers/yeb3luefvf">npm-search-mcp-server MCP server</a>

Available Tools

- search_npm_packages - Search for npm packages.
- Required arguments:
- query (string): The search query.

Claude Screenshot

Installation

Installing via Smithery

To install npm-search for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install npm-search-mcp-server --client claude

Using NPM (recommended)

Alternatively you can install npm-search-mcp-server via npm:

npm install -g npm-search-mcp-server

After installation, you can run it as a command using:

npm-search-mcp-server

Using uv

When using uv no specific installation is needed. We will
use uvx to directly run npm-search-mcp-server.

Configuration

Configure for Claude.app

Add to your Claude settings:

<details>
<summary>Using npm installation</summary>

"mcpServers": {
  "npm-search": {
    "command": "npx",
    "args": ["-y", "npm-search-mcp-server"]
  }
}
</details>

<details>
<summary>Using uvx</summary>

"mcpServers": {
  "npm-search": {
    "command": "uvx",
    "args": ["npm-search-mcp-server"]
  }
}
</details>

Configure for Zed

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>

<details>
<summary>Using uvx</summary>

"context_servers": [
  "npm-search-mcp-server": {
    "command": "uvx",
    "args": ["npm-search-mcp-server"]
  }
],
</details>

Example Interactions

1. Search for npm packages:

{
"name": "search_npm_packages",
"arguments": {
"query": "express"
}
}

Response:
{
"results": [
{
"name": "express",
"description": "Fast, unopinionated, minimalist web framework",
"version": "4.17.1",
"author": "TJ Holowaychuk",
"license": "MIT"
},
...
]
}

Debugging

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

Examples of Questions for Claude

1. "Search for express package on npm"
2. "Find packages related to react"
3. "Show me npm packages for web development"

Build

Docker build:

cd src/npm-search
docker build -t mcp/npm-search .

Contributing

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.

License

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.