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

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

许可证

npm-search-mcp-server 根据 MIT 许可证许可。这意味着您可以自由地使用、修改和分发软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目存储库中的 LICENSE 文件。