项目简介

NPM Search MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,它扩展了大型语言模型(LLM)的能力,使其可以通过 'npm search' 命令来搜索 npm 包。这个服务器充当 LLM 和 npm 仓库之间的桥梁,允许用户通过自然语言指令,让 LLM 调用工具搜索 npm 包信息,并将结果返回给用户。

主要功能点

  • npm 包搜索工具: 提供 'search_npm_packages' 工具,允许 LLM 客户端根据关键词搜索 npm 仓库中的软件包。
  • 标准 MCP 协议: 遵循 MCP 协议标准,易于集成到任何支持 MCP 协议的 LLM 客户端,如 Claude 和 Zed。
  • 易于安装和配置: 支持通过 npm 全局安装,并提供了详细的客户端配置指南。
  • 使用 npm 命令行: 服务器通过执行 'npm search' 命令行工具来完成搜索,确保结果的准确性和实时性。

安装步骤

推荐使用 npm 进行安装,只需执行以下命令即可全局安装 'npm-search-mcp-server':

npm install -g npm-search-mcp-server

服务器配置

为了让 MCP 客户端(例如 Claude 或 Zed)能够连接到 NPM Search MCP Server,您需要在客户端的配置文件中添加以下服务器配置信息。以下是针对 Claude 和 Zed 的配置示例,使用 npm 安装方式:

Claude 配置 (settings.json):

"mcpServers": {
  "npm-search": {
    "command": "npx",
    "args": ["-y", "npm-search-mcp-server"]
  }
}
  • 'server name': 'npm-search' (服务器在客户端中显示的名称,可以自定义)
  • 'command': 'npx' (启动服务器的命令,这里使用 npx 来运行 npm 包)
  • 'args': '["-y", "npm-search-mcp-server"]' (传递给命令的参数,'-y' 忽略安装提示,'npm-search-mcp-server' 是要执行的服务器程序)

Zed 配置 (settings.json):

"context_servers": {
  "npm-search-mcp-server": {
    "command": "npx",
    "args": ["-y", "npm-search-mcp-server"]
  }
}
  • 'server name': 'npm-search-mcp-server' (服务器在客户端中显示的名称,可以自定义)
  • 'command': 'npx' (启动服务器的命令)
  • 'args': '["-y", "npm-search-mcp-server"]' (传递给命令的参数)

基本使用方法

配置完成后,您可以在支持 MCP 协议的 LLM 客户端中,通过自然语言指令来触发 npm 包搜索。例如,在 Claude 中,您可以提问:

  • "Search for express package on npm"
  • "Find packages related to react"
  • "Show me npm packages for web development"

LLM 客户端会将这些自然语言指令转换为对 'search_npm_packages' 工具的调用,并将搜索关键词作为参数传递给服务器。服务器执行 'npm search' 命令后,会将搜索结果返回给 LLM 客户端,最终呈现给用户。

工具调用示例 (JSON 格式):

以下是一个调用 'search_npm_packages' 工具的 JSON 请求示例,用于搜索 "express" 相关的 npm 包:

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

服务器会返回包含搜索结果的 JSON 响应。

信息

分类

开发者工具