项目简介
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 响应。
信息
分类
开发者工具