AI导哈

npm包搜索服务器

一个基于Model Context Protocol的服务器，提供npm包搜索功能，支持stdio和HTTP传输模式。

  • by btwiuse
  • JavaScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 btwiuse/npm-search-mcp-server

使用说明

npm搜索MCP服务器

一个模型上下文协议服务器，允许您通过调用 npm search 命令。

特征：

  • 使用以下命令搜索npm包 npm search 命令
  • 支持stdio和HTTP（可流式传输HTTP）传输模式
  • HTTP模式在以下情况下自动启用 PORT 环境变量已设置
  • 使用Pino进行结构化日志记录
  • 优雅的停机处理
  • 健康检查端点(/health)
  • HTTP传输的会话管理

可用工具

  • search_npm_packages -搜索npm包。
    • 必需参数：
      • query （string）：搜索查询。

安装

通过Smithery安装

要安装npm，请通过以下方式自动搜索Claude Desktop 史密瑟里:

npx -y @smithery/cli install npm-search-mcp-server --client claude

使用NPM（推荐）

或者，您可以安装 npm-search-mcp-server 通过npm：

npm install -g npm-search-mcp-server

安装后，您可以使用以下命令将其作为命令运行：

npm-search-mcp-server

使用紫外线

使用时 uv 不需要特定的安装。我们将 使用 uvx 直接运行 npm搜索mcp服务器.

配置

为Claude.app进行配置

添加到您的Claude设置中：

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

为Zed配置

添加到您的Zed settings.json：

Using npm installation 
"context_servers": {
  "npm-search-mcp-server": {
    "command": "npx",
    "args": ["-y", "npm-search-mcp-server"]
  }
},
Using uvx 
"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

给克劳德的问题示例

  1. “在npm上搜索快递包”
  2. “查找与响应相关的包”
  3. “向我展示用于web开发的npm包”

码头工人

服务器可以在支持HTTP传输的Docker容器中运行：

# Build the image
docker build -t mcp/npm-search .

# Run the container (default port 3009)
docker run -p 3009:3009 mcp/npm-search

# Run with custom port via environment variable
docker run -p 3009:3009 -e PORT=3009 mcp/npm-search

Docker镜像在以下情况下使用HTTP传输 PORT 设置环境变量。服务器公开：

  • POST /mcp -用于工具调用和会话初始化的主MCP端点
  • GET /mcp -流式响应的SSE流端点（需要会话ID）
  • DELETE /mcp -会话终止端点
  • GET /health -带有服务状态和活动会话计数的健康检查端点

对于Docker Compose集成：

services:
  npm-search-mcp:
    build: .
    ports:
      - "3009:3009"
    environment:
      PORT: 3009

贡献

我们鼓励为扩展和改进npm搜索mcp服务器做出贡献。无论你是想添加新的npm相关工具，增强现有功能，还是改进文档，你的投入都是有价值的。

有关其他MCP服务器和实现模式的示例，请参阅： https://github.com/modelcontextprotocol/servers

欢迎拉取请求！欢迎贡献新想法、bug修复或增强功能，使npm搜索mcp服务器更加强大和有用。

许可证

npm search mcp服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

相关 MCP