零Key也能用:cve-mcp-server免费工具快速体验与核心功能上手攻略
零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 漏洞研判。
为什么零 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"
}
}
}
⚠️ 两个关键注意点:
cwd必须使用绝对路径,相对路径会静默失败- 修改配置后必须完全退出 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 的设计,让个人开发者、安全新手都能零成本起步:
- ✅ 无 Key 即可用 8 个免费工具 + 编排器 + 风险评分
- ✅ 免费 NVD Key 一键提速 10 倍
- ✅ 按需解锁 IP 信誉、威胁情报等高级能力
从"问一句话"开始,让 AI 成为你的安全分析师 🛡️
