npm-search MCP 服务器

一个 Model Context Protocol 服务器，允许您通过调用 npm search 命令来搜索 npm 包。

可用工具

• 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 设置中：

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

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

为 Zed 配置

添加到您的 Zed settings.json 中：

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

示例交互

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 文件。