零Key也能用:cve-mcp-server免费工具快速体验与核心功能上手攻略

原创2026-10-11 17:16:251,431 阅读

零Key也能用:cve-mcp-server免费工具快速体验与核心功能上手攻略

cve-mcp-server 是一款生产级的安全情报 MCP 服务器,它为 Claude 提供 28 个安全工具、覆盖 24 个数据源。最关键的是:零 API Key 即可起步——NVD、EPSS、CISA KEV、OSV.dev、MITRE ATT&CK 等 8 个免费工具开箱即用,无需注册任何账号,几分钟内就能让 AI 帮你完成 CVE 漏洞研判。

cve-mcp-server 安全情报服务器项目 Banner:27 个安全情报工具、漏洞情报、威胁情报与风险评分

为什么零 Key 也能用?

很多安全工具的门槛在于各家 API Key:Shodan、VirusTotal、GreyNoise 都需要注册。而 cve-mcp-server 的一大设计亮点是渐进式密钥策略:

  • 免费层(零 Key):NVD(限流 5 次/30 秒)、EPSS、CISA KEV、OSV.dev、MITRE ATT&CK、CWE 库、CVSS 解析、Ransomwhere 全部走公开接口,无需任何凭据
  • 免费提速层:注册免费的 NVD_API_KEY 后,NVD 查询速率从 5 次/30 秒提升到 50 次/30 秒,10 倍性能提升
  • 可选增强层:IP 信誉、主机侦察、恶意软件扫描等高级功能再按需添加对应 Key

相关密钥与速率配置定义在 config.py 中,服务器会自动检测你配置了哪些 Key 并动态调整请求速率。

3 分钟快速上手:零 Key 安装步骤

前提条件:Python 3.10+(推荐 3.11/3.12)、pip 或 uv 包管理器。

# 1. 克隆仓库
git clone https://gitcode.com/gh_mirrors/cv/cve-mcp-server
cd cve-mcp-server

# 2. 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate        # Windows PowerShell 用 .\venv\Scripts\Activate.ps1

# 3. 安装依赖
pip install -e .

# 4. 验证服务器能正常启动(无需 .env 文件!)
python -m cve_mcp.server

如果服务器成功启动且不报错,零 Key 体验环境就搭建完成了。项目入口逻辑位于 server.py,所有 28 个 MCP 工具都在此文件通过 @mcp.tool() 装饰器注册。

接入 Claude

在 Claude Desktop 的配置文件中添加(macOS 位于 ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cve-mcp": {
      "command": "python",
      "args": ["-m", "cve_mcp.server"],
      "cwd": "/绝对路径/cve-mcp-server"
    }
  }
}

⚠️ 两个关键注意点:

  1. cwd 必须使用绝对路径,相对路径会静默失败
  2. 修改配置后必须完全退出 Claude Desktop(Cmd+Q / Alt+F4)再重启,仅刷新不够

零 Key 可用的 8 个免费工具速查表

工具 能做什么 示例问法
lookup_cve 查询 NVD 完整 CVE 记录:CVSS 分数、CWE、受影响产品 "CVE-2024-3400 的详情是什么?"
search_cves 按关键词、产品名、严重级别搜索 CVE "搜一下 Apache 相关的 CRITICAL 漏洞"
get_epss_score 获取 EPSS 30 天内被利用的概率(0–1) "CVE-2024-3400 的 EPSS 分数是多少?"
check_kev_status 查询是否进入 CISA 已知被利用漏洞目录 "这个 CVE 在 KEV 目录里吗?"
get_cvss_details 逐指标拆解 CVSS v3.1 向量字符串 "解释一下这个 CVSS 向量"
get_cwe_info 查询内置 CWE 弱点库详情 "CWE-79 是什么弱点?"
scan_dependencies 用 OSV.dev 扫描开源依赖包漏洞 "扫描 requests 2.28.0 是否有漏洞"
check_ransomware 查询勒索软件比特币地址交易数据 "这个 BTC 地址和勒索软件有关吗?"

此外,triage_cve 一次调用编排器和 calculate_risk_score 风险评分同样零 Key 可用(使用 Key 后数据更全),是本文后面实战场景的主角。

核心功能实战:4 个典型使用场景

场景 1:一键研判 Log4Shell

直接问 Claude:

CVE-2021-44228 需要立即打补丁吗?给我风险评分和建议。

Claude 会自动调用 triage_cve 编排器(源码见 server.py),并行扇出 NVD + EPSS + CISA KEV + PoC 检索,然后计算综合风险分。对 Log4Shell 这类漏洞,典型结果会是:

→ lookup_cve("CVE-2021-44228")   CVSS 3.1: 10.0 (CRITICAL)
→ get_epss_score(...)             EPSS: 0.97531 (97.5%)
→ check_kev_status(...)           ✅ 在 CISA KEV 中,含勒索软件利用
→ calculate_risk_score(...)       风险分: 97/100 → PATCH IMMEDIATELY

整个过程只需一次工具调用,替代了以往在 5、6 个网站间来回切换的手工研判。

场景 2:零 Key 扫描 Python 依赖

扫描这些依赖:requests==2.28.0, flask==2.2.0, django==3.2.0

scan_dependencies 工具(dependency_scan.py)会调用免费的 OSV.dev 接口,返回每个包的已知漏洞数量和升级建议。这是零 Key 用户日常最实用的功能之一——开发团队不用配置任何东西就能做供应链漏洞检查。

场景 3:看懂风险评分公式

calculate_risk_score 输出 0–100 的综合分,公式并不神秘:

风险分 = CVSS×0.20 + EPSS×0.35 + KEV×0.30 + PoC×0.15
  • EPSS 权重最高(35%):它是"未来 30 天内是否真的会被利用"的最强预测指标
  • KEV 权重 30%:已确认在野利用,是"事实"而非预测;且 KEV 条目有硬性覆盖规则——只要进了 KEV 目录,评分最低锁定为 CRITICAL(≥76 分),详见 risk_scorer.py
  • CVSS 权重 20%:只反映理论严重程度,不代表会被利用
分数区间 等级 建议动作
0 – 25 LOW 排入下个维护窗口
26 – 50 MEDIUM 30 天内修复
51 – 75 HIGH 7 天内修复并升级汇报
76 – 100 CRITICAL 24–48 小时内紧急修复

场景 4:深度模式生成 SSVC 决策

triage_cve 支持 depth 参数(quick / standard / deep),deep 模式会额外输出 CISA SSVC v2 门控决策(Act / Attend / Track),作为 0–100 数字分之外的可解释定性决策,实现逻辑在 ssvc.py。

配置进阶:如何渐进式添加 Key

所有密钥通过环境变量读取(定义见 config.py),推荐优先级:

优先级 环境变量 作用 获取成本
必配 NVD_API_KEY NVD 查询提速 10 倍 免费、邮件即时发放
必配 GITHUB_TOKEN 利用 PoC 搜索限速 60/时 → 5000/时 免费 PAT
推荐 ABUSEIPDB_KEY IP 信誉查询(1000 次/天) 免费账号
推荐 VIRUSTOTAL_KEY 文件/URL 多引擎扫描 免费账号
可选 SHODAN_KEY / GREYNOISE_API_KEY 主机侦察 / 扫描活动情报 免费层可用

在 .env 文件中写入即可,例如:

echo 'NVD_API_KEY=你的key' > .env

无需 Key 的高级工具被调用时会优雅降级(返回提示信息而非崩溃),这也是零 Key 起步的安全网。

项目结构:3 分钟看懂源码布局

src/cve_mcp/
├── server.py              # 入口:28 个 MCP 工具全部注册于此
├── config.py              # 环境变量、API 地址、速率限制
├── models.py              # Pydantic 数据模型(CVERecord、KEVEntry 等)
├── audit.py               # 审计日志(50MB 轮转,Key 永不落盘)
├── api/                   # 各数据源客户端
│   ├── nvd_client.py      # NVD REST API v2.0
│   ├── epss_client.py     # FIRST EPSS
│   ├── kev_client.py      # CISA KEV 目录
│   ├── attack_mapping.py  # MITRE ATT&CK 映射
│   └── dependency_scan.py # OSV 依赖扫描
└── utils/
    ├── risk_scorer.py     # 综合风险评分引擎
    └── validators.py      # CVE ID / IP / hash 输入校验

两个值得关注的生产级设计:

  • 本地 SQLite 缓存:CVE 记录缓存 1 小时、EPSS 缓存 6 小时,减少重复请求(rate_limiter.py 还内置了 NVD 令牌桶限流器)
  • 安全姿态:只发出不入的 HTTPS 流量、私有 IP 查询全部拦截、审计日志(audit.py)中 API Key 和响应体永不写入

常见问题排查

Claude Desktop 里看不到工具(🔨图标) 检查 JSON 语法(无尾逗号)、cwd 用绝对路径、完全退出后重启。

NVD 查询提示限流 零 Key 时 NVD 仅 5 次/30 秒,请求会进队列排队;申请一个免费 NVD Key 即可提速 10 倍。triage_cve 在 NVD 不可达时还会自动回退到 VulnCheck NVD++ 数据源。

想交互式调试每个工具 可以用 MCP Inspector 打开浏览器调试界面:

npx @modelcontextprotocol/inspector python -m cve_mcp.server

总结:零门槛的安全情报入口

cve-mcp-server 的核心价值在于把"查 NVD → 查 EPSS → 查 KEV → 查 PoC → 心算风险"的重复劳动,压缩成一句自然语言提问。而零 Key 可用 + 渐进式加 Key 的设计,让个人开发者、安全新手都能零成本起步:

  1. ✅ 无 Key 即可用 8 个免费工具 + 编排器 + 风险评分
  2. ✅ 免费 NVD Key 一键提速 10 倍
  3. ✅ 按需解锁 IP 信誉、威胁情报等高级能力

从"问一句话"开始,让 AI 成为你的安全分析师 🛡️

登录后查看全文
cve-mcp-server