CIRCL CVE SEARCH MCP Server

CIRCL CVE SEARCH MCP Server

一个用于访问 CIRCL Vulnerability-Lookup 平台的模型上下文协议（MCP）服务，提供全面的跨来源漏洞和安全信息。

此服务此前使用旧版 cve.circl.lu cve-search API。CIRCL 已用 Vulnerability-Lookup 取代该服务，因此此服务现在调用 https://vulnerability.circl.lu/api。

功能

此 MCP 服务提供可靠的工具，用于访问：

• CVE 信息：获取特定通用漏洞披露的详细信息
• 供应商浏览：浏览供应商的已知产品，以发现特定供应商产品中的安全问题
• CWE 信息：获取通用弱点枚举信息，以了解漏洞类型
• CAPEC 信息：获取通用攻击模式枚举与分类数据，以了解攻击方法
• 近期漏洞：获取最近发布或更新的漏洞，这些漏洞已关联平台追踪的所有来源

主要改进

• 重试逻辑：通过指数退避自动重试，确保 API 调用可靠
• 增强格式：结构化、易读的响应格式，并突出显示关键信息
• 更完善的错误处理：提供清晰、可操作的错误消息和故障排查指导
• 输入验证：对所有输入进行全面验证和清理

安装

npm install @cyreslab/circl-cve-search-mcp-server

用法

将此服务添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "circl-cve-search": {
      "command": "npx",
      "args": ["@cyreslab/circl-cve-search-mcp-server"]
    }
  }
}

可用工具

get_cve

根据 CVE ID 获取特定 CVE 的详细信息。

参数：

• cve_id（必需）：CVE 标识符（例如，“CVE-2021-44228”）

示例：

{
  "name": "get_cve",
  "arguments": {
    "cve_id": "CVE-2021-44228"
  }
}

响应格式：

• 结构化的 CVE 数据，并突出显示关键信息
• 摘要、发布日期、CVSS 分数
• 关联的弱点类型（CWE）和引用数量
• 用于详细分析的完整原始数据

browse_vendor

按最近的漏洞活动排序，浏览供应商的已知产品。

参数：

• vendor（必需）：供应商名称（例如，“apache”、“microsoft”、“google”）
• limit（可选）：返回结果数量（默认值：10，最大值：50）

示例：

{
  "name": "browse_vendor",
  "arguments": {
    "vendor": "apache",
    "limit": 15
  }
}

响应格式：

• 指定供应商的已知产品列表，每个产品都附有最近变更时间戳
• 总数和显示数量
• 供应商名称规范化

get_cwe

根据 ID 获取通用弱点枚举（CWE）信息。

参数：

• cwe_id（必需）：CWE 标识符（例如，“CWE-79”、“CWE-89”）

示例：

{
  "name": "get_cwe",
  "arguments": {
    "cwe_id": "CWE-79"
  }
}

响应格式：

• CWE 名称和详细描述
• 扩展描述和弱点层级
• 可利用性可能性信息
• 用于全面分析的完整原始数据

get_capec

根据 ID 获取通用攻击模式枚举与分类（CAPEC）信息。

参数：

• capec_id（必需）：CAPEC 标识符（例如，“CAPEC-66”、“CAPEC-89”）

示例：

{
  "name": "get_capec",
  "arguments": {
    "capec_id": "CAPEC-66"
  }
}

响应格式：

• 攻击模式名称和描述
• 常见严重程度和攻击可能性
• 前提条件和相关弱点
• 用于深入分析的完整原始数据

get_recent_vulnerabilities

获取最近发布或更新的漏洞，这些漏洞已关联平台追踪的所有来源（例如 NVD、GitHub、PySec、GSD，以及各供应商的 CSAF 公告）。

参数：

• limit（可选）：返回结果数量（默认值：10，最大值：50）

示例：

{
  "name": "get_recent_vulnerabilities",
  "arguments": {
    "limit": 10
  }
}

响应格式：

• 最近变更的漏洞列表，已针对平台的不同原生记录格式进行规范化（OSV 风格记录、CVE 5.x 记录和 CSAF 公告）
• 每项漏洞的标识符、发布日期或修改日期、截断后的摘要、严重程度和引用数量

数据源

此服务使用 CIRCL 的 Vulnerability-Lookup 平台，该平台取代了此前托管在 cve.circl.lu 上的旧版 cve-search 服务。它提供：

• 跨来源关联的漏洞数据（NVD、GitHub、PySec、GSD、来自各供应商的 CSAF 公告等）
• 通用平台枚举（CPE）信息
• 通用弱点枚举（CWE）数据
• 通用攻击模式枚举与分类（CAPEC）数据
• 持续更新的最新漏洞信息

速率限制

CIRCL Vulnerability-Lookup API 可免费使用，无需身份验证。不过，请负责任地使用，并避免发送过多请求，以免影响服务。

错误处理

此服务可处理各种错误情况：

• 无效的 CVE/CWE/CAPEC ID 格式
• 搜索查询为空
• API 速率限制
• 网络错误
• 无效参数

开发

构建

npm run build

在开发环境中运行

npm run dev

许可证

MIT 许可证——详情请参阅 LICENSE 文件。

贡献

欢迎贡献！欢迎提交 Pull Request。

支持

如有问题或疑问：

• GitHub Issues：报告问题
• CIRCL Vulnerability-Lookup API 文档：https://vulnerability.circl.lu/api/