npm-search MCP 服务器

一个模型上下文协议 (Model Context Protocol, MCP) 服务器，允许您通过调用 npm search 命令来搜索 npm 包。

<a href="https://glama.ai/mcp/servers/yeb3luefvf"><img width="380" height="200" src="https://glama.ai/mcp/servers/yeb3luefvf/badge" alt="npm-search-mcp-server MCP server" /></a>

可用工具

• search_npm_packages - 搜索 npm 包。
  • 必需参数：
    • query (字符串): 搜索查询。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 npm-search：

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

使用 NPM (推荐)

或者，您可以通过 npm 安装 npm-search-mcp-server：

npm install -g npm-search-mcp-server

安装完成后，您可以使用以下命令运行它：

npm-search-mcp-server

使用 uv

当使用 uv 时，无需进行特定安装。我们将使用 uvx 直接运行 npm-search-mcp-server。

配置

为 Claude.app 配置

添加到您的 Claude 设置：

<details> <summary>使用 npm 安装</summary>

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

</details>

<details> <summary>使用 uvx</summary>

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

</details>

为 Zed 配置

添加到您的 Zed settings.json：

<details> <summary>使用 npm 安装</summary>

"context_servers": {
  "npm-search-mcp-server": {
    "command": "npx",
    "args": ["-y", "npm-search-mcp-server"]
  }
},

</details>

<details> <summary>使用 uvx</summary>

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

</details>

示例交互

1. 搜索 npm 包：

{
  "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"
    },
    ...
  ]
}

调试

您可以使用 MCP 检查器来调试服务器。 对于 uvx 安装：

npx @modelcontextprotocol/inspector npx -y npm-search-mcp-server

或者，如果您已将软件包安装在特定目录中或正在开发它：

cd path/to/servers/src/npm-search
npx @modelcontextprotocol/inspector uv run npm-search-mcp-server

Claude 的问题示例

1. "在 npm 上搜索 express 包"
2. "查找与 react 相关的包"
3. "向我展示用于 Web 开发的 npm 包"

构建

Docker 构建：

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

贡献

我们鼓励您贡献力量，以帮助扩展和改进 npm-search-mcp-server。 无论您是想添加新的 npm 相关工具、增强现有功能还是改进文档，您的投入都很有价值。

有关其他 MCP 服务器和实现模式的示例，请参见： https://github.com/modelcontextprotocol/servers

欢迎提交 Pull Request！ 随时贡献新的想法、错误修复或增强功能，以使 npm-search-mcp-server 更加强大和有用。

许可证

npm-search-mcp-server 在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参见项目存储库中的 LICENSE 文件。