touful-vuln-search-mcp

统一漏洞搜索 MCP 服务，为渗透测试 Agent 提供一站式漏洞情报检索。

特性

• 5 大数据源：NVD / OSV / EPSS / CISA KEV / Exploit-DB + GitHub
• 10 个 MCP 工具：覆盖 CVE 查询、关键词搜索、批量查询、EPSS 评估、KEV 检查、Exploit 搜索、综合研判
• 中文输出：所有工具返回中文 Markdown 格式，含优先级建议
• 代理回退：直连优先→代理自动回退，适用于网络受限环境
• LLM 友好：输入容错（空格/大小写/自然语言）+ 错误提示含格式示例和工具建议

安装

# 克隆仓库
git clone https://github.com/touful/touful-vuln-search-mcp.git
cd touful-vuln-search-mcp

# 安装依赖（含 socks 代理支持）
pip install -e .

配置

复制 .env.example 为 .env，填入 API 密钥：

NVD_API_KEY=your_nvd_api_key_here        # 必需，从 https://nvd.nist.gov/developers 申请
GITHUB_TOKEN=your_github_token_here       # 可选，提高 GitHub 搜索限额
# HTTP_PROXY=socks5://127.0.0.1:7890      # 可选，网络受限时启用

变量	必需	说明
NVD_API_KEY	✅	NVD API 密钥，免费申请
GITHUB_TOKEN	❌	GitHub Personal Access Token，无需任何权限
HTTP_PROXY	❌	代理地址，支持 socks5/http

启动

# HTTP 传输（默认）
python -m src.server --transport http --host 127.0.0.1 --port 8080

# stdio 模式（Claude Desktop / Cursor 集成）
python -m src.server --transport stdio

MCP 客户端配置

Claude Desktop (claude_desktop_config.json)：

{
  "mcpServers": {
    "touful-vuln-search": {
      "command": "python",
      "args": ["-m", "src.server", "--transport", "stdio"],
      "cwd": "/path/to/touful-vuln-search-mcp",
      "env": {
        "NVD_API_KEY": "your-key",
        "GITHUB_TOKEN": "ghp_xxx",
        "HTTP_PROXY": "socks5://127.0.0.1:7890"
      }
    }
  }
}

工具列表

工具	数据源	用途
nvd_get_cve	NVD	查询单个 CVE 详情（CVSS/CWE/CPE/参考链接）
nvd_search_cve	NVD	按关键词搜索 CVE
nvd_get_cves_batch	NVD	批量查询（逗号分隔，最多 100）
osv_query_package	OSV	查询软件包已知漏洞
osv_query_batch	OSV	批量查询软件包漏洞
osv_get_vuln	OSV	查询漏洞详情（含受影响版本范围）
get_epss_score	EPSS	查询漏洞 30 天内被利用概率
check_kev_status	CISA KEV	检查是否在已知被利用漏洞目录
search_exploit	GitHub+Exploit-DB	搜索公开 PoC/Exploit
assess_cve	全部 4 源	🎯 综合评估（CVSS+EPSS+KEV+Exploit 并发查询）

数据源

数据源	说明	需要认证
NVD	美国国家漏洞数据库	✅ API Key
OSV	Google 开源漏洞数据库	无
EPSS	漏洞利用预测评分系统	无
CISA KEV	已知被利用漏洞目录	无
Exploit-DB + GitHub	公开利用代码搜索	❌ Token（可选）

项目结构

touful-vuln-search-mcp/
├── src/
│   ├── server.py            # FastMCP 服务入口，10 个工具定义
│   ├── config.py            # 配置管理（环境变量/API端点）
│   └── clients/
│       ├── base.py          # 公共基类（统一错误处理）
│       ├── http_utils.py    # HTTP 工具（直连→代理回退）
│       ├── nvd_client.py    # NVD API 客户端（aiolimiter 限速）
│       ├── osv_client.py    # OSV API 客户端
│       ├── epss_client.py   # EPSS API 客户端
│       ├── kev_client.py    # CISA KEV 客户端
│       └── exploit_client.py   # Exploit 搜索客户端
├── tests/                   # 测试脚本
│   ├── check_config.py      # 配置检查
│   ├── check_tools.py       # 工具可用性检查
│   ├── integration_test.py  # 集成测试
│   └── test_osv_format.py   # OSV 格式测试
├── scripts/                 # 工具和测试脚本
│   ├── check_cve_2024_1234.py    # CVE 状态检查示例
│   ├── test_clients.py           # 客户端功能测试
│   ├── test_mcp_tools.py         # MCP 工具注册验证
│   ├── test_proxy_fallback.py    # 代理回退验证
│   ├── test_llm_robustness.py    # LLM 输入健壮性测试
│   └── ...                       # 其他验证脚本
├── docs/                    # 文档
├── pyproject.toml
├── .env.example
├── .gitignore
└── README.md

运行测试

# 检查配置是否正确
python tests/check_config.py

# 检查 MCP 工具是否可用
python tests/check_tools.py

# 集成测试
python tests/integration_test.py

# OSV 格式测试
python tests/test_osv_format.py

许可证

MIT