ContrastAPI 是一个面向 AI 智能体的安全情报 MCP 服务器，旨在为智能体提供关于漏洞、威胁和攻击面的有据可查的答案，数据来源包括 NVD、CISA KEV、FIRST EPSS、MITRE ATLAS 与 D3FEND 等权威机构，而非猜测。
主要能力
- 漏洞情报：CVE/KEV/CWE 查询，结合 EPSS 漏洞利用概率和复合风险评分。
- 威胁情报：IOC 富化、MITRE ATLAS 与 D3FEND 框架、Sigma 检测规则。
- 攻击面调查：域名与 IP 调查、DNS、WHOIS、SSL、子域名、邮件安全态势（SPF/DMARC）。
- 代码安全：代码扫描，检测密钥泄露和注入问题。
- 实时网络情报：robots_txt、redirect_chain、email_verify、brand_assets、seo_audit、geo_audit 等工具，并带有明确的伦理底线：按目标限流、遵守 robots.txt、不进行 SMTP 探测。
使用方式
- 作为 MCP 服务器接入 AI 智能体，提供 55 个工具、7 个资源和 3 个提示词。
- Claude Desktop：从最新 release 下载 .mcpb 文件并双击安装（或通过 Claude Desktop → Settings → Extensions → Install Extension…），无需注册和 API 密钥，55 个工具立即可用。
- 其他客户端：提供 Python SDK、Node SDK、cURL、VS Code 支持，参见 mcp-setup 和 quickstart 文档。
- 在线 API：api.contrastcyber.com，提供 REST 参考文档，包含 60+ 端点、认证、速率限制、令牌成本和响应封装说明。
- OpenAPI 规范：openapi.json。
- 也可通过 Smithery、npm、VS Code Marketplace、Awesome OSINT MCP、RapidAPI 获取。
响应特性
- 响应包含 verdict 块：deterministic、falsifiable_fields、data_age_seconds、sources_queried/sources_unavailable、completeness，便于验证智能体独立从上游权威（NVD、RDAP、CT 日志、URLhaus）重新推导特定字段。可通过 GET /v1/capabilities 探测 "verdict_metadata": true。
- CVE 响应嵌入 next_calls: list[PivotHint]，即 {tool, input, reason} 三元组，建议下一个应调用的 MCP 工具（例如当 kev.in_kev=true 时建议 kev_detail，当 cwe_id 设置时建议 cwe_lookup），使智能体无需手动提示即可串联工作流。
适用场景
- AI 智能体需要基于权威来源回答漏洞、威胁和攻击面相关问题。
- 安全分析师进行 CVE/KEV 查询、IOC 富化、域名/IP 调查、邮件安全态势评估。
- 开发者在代码中扫描密钥泄露和注入问题。
- 需要将安全情报工具集成到 MCP 兼容的 AI 工作流中。
限制
- 免费、无需 API 密钥、无需注册。
- 网络情报工具遵守 robots.txt，按目标限流，不进行 SMTP 探测。
- 其他具体限制（如速率限制细节、令牌成本）需参考官方 API 文档。
