npm-search MCP Server

npm-search MCP 服务

一个模型上下文协议服务，可通过调用 npm search 命令搜索 npm 包。

功能：

• 使用 npm search 命令搜索 npm 包
• 支持 stdio 和 HTTP（streamable-http）两种传输模式
• 设置 PORT 环境变量后自动启用 HTTP 模式
• 使用 Pino 进行结构化日志记录
• 支持平滑关闭
• 健康检查端点（/health）
• 管理 HTTP 传输的会话

可用工具

• 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

该服务可在 Docker 容器中运行，并支持 HTTP 传输：

# 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

设置 PORT 环境变量后，Docker 镜像将使用 HTTP 传输。该服务开放以下端点：

• 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-search-mcp-server。无论你是想添加新的 npm 相关工具、增强现有功能，还是改进文档，你的贡献都很有价值。

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

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

许可证

npm-search-mcp-server 采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。