UPinar/contrastapi

UPinar/contrastapi has 37 GitHub stars and 5 forks. GitHot measured +1 stars in 24 hours and +1 in 7 days. Last checked 2026-11-09 22:13 UTC. Last push 2026-11-02.

这些数字如何统计

MCP server with 55 security intelligence tools — CVE/KEV, MITRE ATLAS+D3FEND, Sigma detection rules, email security posture (SPF/DMARC), domain & web intel, threat intel.

37 星标 5 forks +1 24小时

实测星标增长

24小时: +1
7天: +1
15天: 正在收集历史
1个月: 正在收集历史

各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。

README_CN.md

原文

ContrastAPI — 为 AI 智能体打造的 55 个安全工具 + 7 个 MCP 资源

为 AI 智能体打造的安全情报。 让你的智能体获得有据可依的漏洞、威胁与攻击面答案 —— 依托权威数据源（NVD、CISA KEV、FIRST EPSS、MITRE ATLAS 与 D3FEND），而非臆测。CVE/KEV/CWE 查询（含 EPSS 利用概率与综合风险评分）、域名与 IP 调查、IOC 增强、代码安全检查、实时网站情报。55 个工具、7 个资源、3 个 Prompt —— 免费、无需 API 密钥、无需注册。

English · 在线服务： api.contrastcyber.com

支持 DeepSeek、Qwen（通义千问） 等支持 MCP 协议的 AI 模型。

文档

API 文档 — REST 参考：60+ 端点、认证、速率限制、Token 计费与响应封装。
MCP 文档 — MCP 工具选择指南、7 个资源、3 个 Prompt 及可直接复制的智能体提示词。

快速接入（MCP）

{
  "mcpServers": {
    "contrastapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.contrastcyber.com/mcp/"]
    }
  }
}

重启智能体即可。其他客户端（Python SDK、Node SDK、cURL、VS Code）：mcp-setup · quickstart

SDK

pip install contrastapi      # Python 3.10+ — 同步 + 异步、类型化响应、快捷助手
npm install contrastapi      # Node 14+ — 具体 TypeScript 类型、14 个命名空间

两个 SDK 覆盖每一个 HTTP 端点与 MCP 工具 —— CVE/KEV/CWE、ATLAS、D3FEND、Sigma 检测规则、邮箱安全姿态、域名、IP、IOC、代码安全、网站情报 —— 响应结构与服务端完全一致，并提供与 API 错误信封对应的类型化异常层级。同时提供用于浏览 ATLAS、D3FEND、CWE 目录的 MCP 资源（详见 docs/MCP_Documentation.md）以及条件式分诊 Prompt（详见 docs/MCP_Documentation.md#contrast-triage）。网站情报工具 —— robots_txt、redirect_chain、email_verify、brand_assets、seo_audit、geo_audit —— 均遵循明确的伦理底线：按目标限速、遵守 robots.txt、不进行 SMTP 探测。

链接

OpenAPI： openapi.json

自部署 / 测试 / 技术栈

git clone https://github.com/UPinar/contrastapi.git
cd contrastapi && python3 -m venv venv && venv/bin/pip install -r requirements.txt
cd app && ../venv/bin/uvicorn main:app --port 8002
cd app && python -m pytest tests/ -q  # 2636 个测试

Python 3.12 · FastAPI · uvicorn · mcp-python-sdk Streamable HTTP 挂载于 /mcp · SQLite WAL · dnspython + SSRF 安全后端。

其他平台

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）。智能体无需手动提示即可串联工作流。

MIT

UPinar/contrastapi

实测星标增长

README_CN.md

ContrastAPI — 为 AI 智能体打造的 55 个安全工具 + 7 个 MCP 资源

文档

快速接入（MCP）

SDK

链接

探索相关项目

trimstray/the-book-of-secret-knowledge

Hack-with-Github/Awesome-Hacking

swisskyrepo/PayloadsAllTheThings

caddyserver/caddy