关于 Contrastapi — Security Intelligence
ContrastAPI 是面向 AI Agent 的安全情报 API 与 MCP 服务,提供 CVE、KEV、CWE 查询(含 EPSS 与综合风险评分)、域名与 IP 调查、IOC 富化和代码安全检查。项目无需 API Key 即可使用,并附带 SDK 与 MCP 资源。
主要功能
- 01CVE、KEV 与 CWE 查询,含 EPSS 富化
- 02域名与 IP 调查,包括 DNS、WHOIS 与 SSL
- 03IOC 富化与代码安全检查
- 047 个 MCP 资源与 3 个提示词
- 05提供 Python 与 Node SDK
适用场景
- 01为 Agent 提供漏洞与威胁情报依据
- 02对域名或 IP 进行攻击面侦察
- 03检查代码中的密钥、注入与安全响应头问题
MCP 相关
该项目是一个远程 MCP 服务,向 MCP 客户端暴露 55 个安全工具、7 个资源和 3 个提示词,可通过 mcp-remote 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.contrastcyber.com/mcp/claude mcp add --transport http contrastapi https://api.contrastcyber.com/mcp/{"mcpServers":{"contrastapi":{"type":"http","url":"https://api.contrastcyber.com/mcp/"}}}在 Cursor 中打开{"servers":{"contrastapi":{"type":"http","url":"https://api.contrastcyber.com/mcp/"}}}在 VS Code 中打开{"mcpServers":{"contrastapi":{"type":"http","url":"https://api.contrastcyber.com/mcp/"}}}{"mcpServers":{"contrastapi":{"serverUrl":"https://api.contrastcyber.com/mcp/"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
55| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| domain | string | 是 | 要分析的根域名,不含协议或路径(例如 'example.com'、'shopify.com') |
| include_all_txt | boolean | 否 | 返回所有 TXT 记录(默认:False,仅保留 SPF/DMARC/DKIM/MTA-STS/TLS-RPT)。dns.total_txt_records 始终会返回筛选前的实际记录数。默认筛选器会移除供应商验证字符串(google-site-verification、ms=、facebook-domain-verification 等),这些字符串会增加响应内容,却不提供安全信号。仅当需要原始 TXT 清单时才设为 True。 |
详细介绍
ContrastAPI — 为 AI Agent 打造的 55 个安全工具 + 7 个 MCP 资源
为 AI Agent 打造的安全情报。 为你的 Agent 提供有可靠依据的漏洞、威胁和攻击面分析,信息来源权威(NVD、CISA KEV、FIRST EPSS、MITRE ATLAS 和 D3FEND),绝不凭空猜测。支持 CVE/KEV/CWE 查询、EPSS 漏洞利用概率和综合风险评分、域名与 IP 调查、IOC 丰富化、代码安全检查以及实时网络情报。55 个工具、7 个资源和 3 个提示词——免费使用,无需 API 密钥,也无需注册。
中文 · 在线服务: api.contrastcyber.com
文档
- API 文档 — REST 参考:60 多个端点、身份验证、速率限制、令牌成本和响应封装格式。
- MCP 文档 — MCP 工具选择指南、7 个资源、3 个提示词和可直接复制粘贴的 Agent 提示词。
设置(MCP)
任何 MCP 客户端
{
"mcpServers": {
"contrastapi": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.contrastcyber.com/mcp/"]
}
}
}
重启你的 Agent。其他客户端(Python SDK、Node SDK、cURL、VS Code):MCP 设置 · 快速入门
Claude Desktop — 一键安装扩展
从**最新版本**获取 .mcpb 文件并双击(或在 Claude Desktop 中选择 Settings → Extensions → Install Extension…)。无需注册或 API 密钥——所有 55 个工具均可立即使用。
SDK
pip install contrastapi # Python 3.10+ — sync + async, typed responses, shortcut helpers
npm install contrastapi # Node 14+ — concrete TypeScript types, 14 namespaces
两个 SDK 均涵盖所有 HTTP 端点和 MCP 工具——CVE/KEV/CWE、ATLAS、D3FEND、Sigma 规则、电子邮件安全态势、域名、IP、IOC、代码安全和网络情报——提供与线路完全一致的响应结构,以及与 API 错误封装格式相对应的类型化异常层级。它们还提供 MCP 资源,可用于浏览 ATLAS、D3FEND 和 CWE 目录(参见 docs/MCP_Documentation.md),以及一个条件触发的分诊提示词(参见 docs/MCP_Documentation.md#contrast-triage)。网络情报工具——robots_txt、redirect_chain、email_verify、brand_assets、seo_audit、geo_audit——设有明确的伦理底线:按目标限流、遵守 robots.txt、不探测 SMTP。
链接
OpenAPI: openapi.json
也可在以下平台获取
Smithery · npm · VS Code Marketplace · Awesome OSINT MCP · RapidAPI
多 Agent 判定元数据
响应包含一个 verdict 块,包含 deterministic、falsifiable_fields、data_age_seconds、sources_queried / sources_unavailable、completeness,以便验证 Agent 从上游权威来源(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)。Agent 可串联工作流,无需手动提示。
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。