threatcheck

threatcheck

threatcheck 会在 Agent 即将接触的内容前设置威胁情报关卡。在对抓取的网页、电子邮件、工单或工具结果采取行动前，可以扫描其中是否存在提示词注入，以及其中包含的 URL、域名和 IP。在打开链接前，可以查询单个指标——地址、哈希、电子邮件、电话号码——获取信誉判定、风险评分和引用该指标的拦截列表。可以详细查看 CVE，查看最新发布的 CVE 列表，或查看已确认在野外遭到利用的 CVE 列表。你运行的网站或项目的依赖文件也可以纳入每日监控，以便在出现新发现时及时收到通知。

此软件包不会在本地作出任何判断。它会原样返回实时端点提供的工具列表，并将每次工具调用转发至上游，再不作更改地返回任何结果。根据下方的工具说明，部分调用会计入你自己的月度配额；监控工具则会占用你自己套餐中的受监控来源。这里没有任何工具可以购买、充值套餐、结账或生成密钥：这些工具只会消耗你已有账户的配额；发现项工具只会更改你自己组织内发现项的状态。

工具

• scan_before_use — 在采取行动前，扫描不可信内容中的提示词注入，并检查其中包含的 URL、域名和 IP。必需：content。 可选：source_url。返回 block、warn 或 allow 判定。
• check_url — 针对单个 URL、域名或 IP 的轻量预获取检查。必需：url。返回 block、warn 或 allow 判定。
• check_indicator — 全面查看单个指标的信誉信息：IP、域名、URL、文件哈希（MD5、 SHA-1 或 SHA-256）、电子邮件地址或电话号码，支持去武装形式。必需：indicator。 可选：enrichment（fast、standard、basic）以及国家/地区格式电话号码所需的 country。 返回判定、标题、建议操作、0–100 风险评分，并列出引用的阻止列表、证据、 首次/最近发现时间和上下文。消耗每月配额中的 1 次请求。
• get_cve — 获取单个 CVE 的完整信息：描述、严重程度、 CVSS、EPSS、CISA KEV 状态、利用证据、 受影响的软件包和供应商公告。必需： id（例如 CVE-2021-44228）。消耗每月配额中的 1 次请求。
• recent_cves — 按最新发布优先列出最近发布的 CVE， 最多 20 条。可选：severity （CRITICAL、HIGH、MEDIUM、LOW）和 limit （1–20，默认值为 10）。消耗每月配额中的 1 次请求。
• search_indicators — 查找看起来与某品牌或域名有关的已列出域名：仿冒域名、同形异义字符、 使用其他 TLD 的同名域名，以及带有网络钓鱼词的包装域名。 必需：keywords。可选：limit（1–500， 默认值为 50）。消耗每月配额中的 1 次请求。
• check_indicators — 一次调用即可检查最多 100 个指标的信誉，支持混合类型， 并接受去武装形式。必需：indicators。可选： enrichment（basic、standard、full）和 country。发送的每个唯一指标都会消耗每月配额中的 1 次请求。
• scan_email — 在投递或打开邮件前，扫描单封邮件中的网络钓鱼 和恶意软件。必须且只能发送 eml（原始 RFC 5322 邮件）或 message（已解析的字段）其中之一。可选：authservId、 trustAuthenticationResults、trustedHops、connectingIp。返回判定、 建议操作、风险评分、原因以及无法检查的内容。每封邮件消耗扫描 计量中的 1 次扫描。
• exploited_cves — 在近期时间范围内有证据证实遭到利用的 CVE。可选： days（1–30，默认值为 7）和 limit（1–50，默认值为 20）。使用密钥时， 消耗每月配额中的 1 次请求；不使用密钥也可运行，但会按 IP 限流。
• watch_domain — 开始对你运营的一个公开网站进行每日漏洞 监控。必需：domain。可选：name。占用计划中的 1 个受监控来源；重新添加 已监控的域名不产生费用。
• watch_dependencies — 根据项目锁文件或 SBOM 的文本内容开始漏洞 监控（传入内容，而不是路径）。 必需：content 和 name。可选：format 和 includeDev。占用计划中的 1 个受监控来源。
• ack_finding — 设置一条自有监控发现项的状态：ACKNOWLEDGED、PATCHED、 NOT_AFFECTED 或 SNOOZED（需提供 snoozedUntil，最多延后 90 天）。必需：findingId 和 status。

通过 check_indicator 或 check_indicators 检查的电子邮件地址或电话号码，会获得 针对该指标的威胁判定——恶意、可疑、干净或未知，并附带来源——绝不会返回某个人的个人数据， 也绝不会仅仅因为没有相关信息就将其判定为干净。

配置

• ISMALICIOUS_MCP_URL（可选）— 覆盖上游端点。默认值为 https://api.ismalicious.com/mcp。（该覆盖钩子是本次重建自行标注的还原内容。）
• ISMALICIOUS_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 标头，其中包含你自己的 isMalicious API 密钥。未设置时，不会发送密钥 标头，请求将以无密钥方式运行。（环境变量名称由原始记录的 npm 包条目 确认，标头名称则由其远程声明确认；Bearer 格式和转发行为均为标注的 还原内容——原始接口是在无密钥情况下记录的。）

转发机制

首次调用工具时，会向上游打开一个可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求 （protocolVersion 为 2025-03-26，clientInfo 名称为 threatcheck），然后发送 notifications/initialized 通知，接着发送参数保持原样的 tools/call 请求。当上游在 initialize 响应中返回 Mcp-Session-Id 标头时， 后续每个请求都会携带该值，并且会话会在进程存续期间保持有效。响应 可能是普通 JSON，也可能是服务器发送事件；两种格式都会读取。

上游成功结果会原样传递，包括上游设置的任何 isError 标记。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或 无法完成的请求——会以 isError 结果返回，其 文本以 threatcheck error: 开头（此呈现方式是本次重建自行标注的还原内容）。

CLI

每个工具也可作为子命令使用，接受一个 JSON 参数字符串：

npx @reneturcios/threatcheck check_url '{"url":"https://example.com"}'
npx @reneturcios/threatcheck check_indicator '{"indicator":"203.0.113.7"}'
npx @reneturcios/threatcheck get_cve '{"id":"CVE-2021-44228"}'
npx @reneturcios/threatcheck --version

退出代码：成功时为 0，结果为 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/threatcheck mcp

MCP 客户端配置：

{
  "mcpServers": {
    "threatcheck": {
      "command": "npx",
      "args": ["-y", "@reneturcios/threatcheck", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/threatcheck
docker run --rm ghcr.io/cloudcorprecords/threatcheck --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对存根 JSON-RPC 上游运行，不会进行实际网络调用。

许可证

MIT — 参见 LICENSE。