NPM Sentinel MCP

一款强大的模型上下文协议 (MCP) 服务器，通过 AI 彻底改变了 NPM 包分析。它构建于 Claude 和 Anthropic AI 之上，提供关于包安全、依赖关系和性能的实时情报。这款 MCP 服务器提供即时洞察和智能分析，以保护和优化您的 npm 生态系统，使现代开发工作流程中的包管理决策更快、更安全。

功能特性

版本分析和跟踪
依赖项分析和映射
安全漏洞扫描
包质量指标
下载趋势和统计数据
TypeScript 支持验证
包大小分析
维护指标
实时包比较
标准化的错误处理和 MCP 响应格式
高效的缓存，以提高性能和管理 API 速率限制
使用 Zod 进行严格的模式验证和类型安全

注意：服务器通过MCP集成提供AI辅助分析。

安装

在VS Code中安装

将以下内容添加到您的VS Code MCP配置文件中。更多信息请参见VS Code MCP 文档。

{
  "servers": {
    "npm-sentinel": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@nekzus/mcp-server@latest"]
    }
  }
}

Docker

构建

# 构建Docker镜像
docker build -t nekzus/npm-sentinel-mcp .

使用

您可以使用Docker运行MCP服务器，并挂载目录到/projects：

json
{
  "mcpServers": {
    "npm-sentinel-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-w", "/projects",
        "--mount", "type=bind,src=${PWD},dst=/projects",
        "nekzus/npm-sentinel-mcp",
        "node",
        "dist/index.js"
      ]
    }
  }
}

对于多个目录：

{
  "mcpServers": {
    "npm-sentinel-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-w", "/projects",
        "--mount", "type=bind,src=/path/to/workspace,dst=/projects/workspace",
        "--mount", "type=bind,src=/path/to/other/dir,dst=/projects/other/dir,ro",
        "nekzus/npm-sentinel-mcp",
        "node",
        "dist/index.js"
      ]
    }
  }
}

注意：所有挂载的目录必须位于 /projects 下才能正确访问。

与 Claude 桌面版一起使用

将以下内容添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "npmsentinel": {
      "command": "npx",
      "args": ["-y", "@nekzus/mcp-server@latest"]
    }
  }
}

配置文件位置：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Linux：（Claude 桌面版目前尚不支持 Linux）

NPX


json
{
  "mcpServers": {
    "npm-sentinel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nekzus/mcp-server@latest"
      ]
    }
  }
}

API

服务器通过模型上下文协议 (MCP) 提供其工具。所有工具都遵循标准化的响应格式：

{
  "content": [
    {
      "type": "text",
      "text": "字符串",
      "isError": 布尔值 // 可选
    }
    // ... 如有必要，可添加更多内容项
  ]
}

资源

npm://registry: NPM 注册表接口
npm://security: 安全分析接口
npm://metrics: 包指标接口

服务器资源

服务器还提供以下信息资源，可通过 MCP GetResource 请求访问：

doc://server/readme:
- 描述: 获取此 NPM Sentinel MCP 服务器的主 README.md 文件内容。
- MIME 类型: text/markdown
doc://mcp/specification:
- 描述: 获取 llms-full.txt 内容，提供全面的模型上下文协议规范。
- MIME 类型: text/plain

工具

npmVersions

获取包的所有版本
输入: packages (字符串数组)
返回: 包含发行日期的版本历史记录

npmLatest

获取最新版本信息
输入: packages (字符串数组)
返回: 最新版本详情和变更日志

npmDeps

分析包依赖关系
输入: packages (字符串数组)
返回: 完整的依赖树分析

npmTypes

检查 TypeScript 支持
输入：packages (字符串数组)
返回：TypeScript 兼容性状态

npmSize

分析包大小
输入：packages (字符串数组)
返回：包大小和导入成本分析

npmVulnerabilities

扫描安全漏洞
输入：packages (字符串数组)
返回：安全建议和严重性等级

npmTrends

获取下载趋势
输入：
- packages (字符串数组)
- period ("last-week" | "last-month" | "last-year")
返回：一段时间内的下载统计数据

npmCompare

比较多个包
输入：packages (字符串数组)
返回：详细的比较指标

npmMaintainers

获取包维护者信息
输入：packages (字符串数组)
返回：维护者信息和活动

npmScore

获取包质量评分
输入：packages (字符串数组)
返回：全面的质量指标

npmPackageReadme

获取包自述文件
输入：packages (字符串数组)
返回：格式化的自述文件内容

npmSearch

搜索包
输入：
- query (字符串)
- limit (数字，可选)
返回：匹配的包及其元数据

npmLicenseCompatibility

检查许可证兼容性
输入：packages (字符串数组)
返回：许可证分析和兼容性信息

npmRepoStats

获取仓库统计信息
输入：packages (字符串数组)
返回：GitHub/仓库指标

npmDeprecated

检查是否已弃用
输入：packages (字符串数组)
返回：弃用状态和替代方案

npm变更日志分析

分析包的变更日志
输入：packages (字符串数组)
返回：变更日志摘要和影响分析

npm替代方案

查找包的替代方案
输入：packages (字符串数组)
返回：类似的包及其比较

npm质量评估

评估包的质量
输入：packages (字符串数组)
返回：质量指标和评分

npm维护状态

检查维护状态
输入：packages (字符串数组)
返回：维护活动指标

构建

# 使用 npm 构建
npm install
npm run build

许可证

本 MCP 服务器采用 MIT 许可证授权。这意味着您可以在 MIT 许可证的条款和条件下自由使用、修改和分发此软件。更多详情，请参阅项目仓库中的 LICENSE 文件。