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

示例交互

以下是一个请求和响应示例：

请求：

{
  "intent": "search_npm_packages",
  "arguments": {
    "query": "node"
  }
}

响应：

{
  "result": {
    "packages": [
      {
        "name": "node",
        "version": "16.14.2",
        "description": "Node.js: A platform built on Chrome's JavaScript runtime."
      },
      // 更多结果...
    ]
  }
}

调试

要调试服务器，请运行：

npm run debug

然后使用支持 LSP 的编辑器（如 VS Code）连接到端点 127.0.0.1:3000。

构建

你可以通过以下命令构建项目：

docker build -t npm-search-mcp-server .

贡献和许可

该项目是开源的，使用 MIT 许可证。有关贡献和更多信息，请访问 GitHub 仓库。

以上为完整翻译内容。