← 返回目录
A

Agentic Threat Hunting Framework MCP Server

社区
为威胁狩猎项目提供记忆、结构与智能体能力
分类
其他 第 71 / 230
Stars
★ 392 非常热门
传输方式
stdio(本地进程) · SSE · Streamable HTTP
运行环境
Python 3.8+
凭据
无需凭据
许可证
MIT
最近提交
60FMRS · C

ATHF 是一个 MIT 许可的威胁狩猎框架,由 Nebulock Inc. 维护,作者为 Sydney Marrone。其 MCP 服务器(v0.11.0 起)暴露 17 个工具,覆盖狩猎管理、语义搜索、ATT&CK 覆盖度、研究和假设生成。默认 stdio 传输最安全;sse/streamable-http 传输未经认证且绑定本地回环,README 明确提示需谨慎使用并前置认证代理。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 9/20

可靠性
9/20
安全与权限
13/20
维护活跃度
12/20
文档质量
13/20
安装易用性
13/20
查看各项评分依据
可靠性 9/20
静态审查仅见 README,未获得仓库源码、server manifest、测试或 CI 配置,无法验证 `athf-mcp` 入口、17 个工具是否与文档声明一致,也无法确认 stdio/sse 传输的握手与初始化是否可靠。加分点:README 明确给出 `athf mcp serve --workspace` 与 `athf-mcp` 两种启动方式、workspace 通过 cwd 或 ATHF_WORKSPACE 自动探测,happy path 描述较具体;ATT&CK 数据在缺少 mitreattack-python 时有硬编码 v14 回退,说明对可选依赖有降级设计。扣分点:无提交的测试、无 CI 证据,Python 3.8-3.13 的兼容矩阵与语义搜索、LLM 代理调用等关键路径均无法复核;错误处理、失败诊断、超时/重试策略完全缺失。按静态校准上限 12 分,因缺少可验证执行证据且不确定性高,判 9 分。
安全与权限 13/20
未触发红线:未见恶意代码、凭据窃取、隐蔽外传、未确认的不可逆操作或伪造身份;安装示例中也不含真实令牌。最突出的正面证据是 README 主动披露 sse/streamable-http 传输绑定 127.0.0.1 且无认证,提示每个工具都会读取整个 workspace、部分工具会调用 LLM 产生费用,并建议前置认证代理——这种数据流与副作用的自我披露是加分项,默认 stdio 不开套接字也符合最小暴露原则。扣分点:MCP 服务器本身没有任何认证/授权层,只靠绑定地址和外部代理;所有工具对 workspace 拥有全量读写,无按目录/按工具的最小权限粒度;LLM 代理调用(hypothesis-generator)会消耗用户额度但没有确认或配额机制;未见凭据存储、日志脱敏、审计追踪的设计说明。主风险可见但权限、确认与作用域控制不完整,介于 10-14 之间,判 13。
维护活跃度 12/20
有 MIT 许可证、370 stars、仅 4 个 open issues,README 显示持续演进至 v0.11.0(MCP、ATT&CK 数据管理),并给出 PyPI 发布与版本徽章,说明发布节奏与版本语义存在。扣分点:未提供 commit 历史、release 列表、issue 响应时间、依赖更新策略或安全响应渠道(如 SECURITY.md)的证据,维护者身份仅记为个人作者署名,缺少组织级治理与长期支持承诺。属于活跃但治理/版本证据缺口明显的状态,判 12。
文档质量 13/20
文档层次较丰富:Quick Start 三种安装路径(PyPI/源码/纯 Markdown)、完整 CLI 命令参考、LOCK 模式与五级成熟度模型解释、MCP 客户端配置 JSON 示例、以及指向 CLI_REFERENCE、MCP_CATALOG、quickstart 等外部文档的链接,示例命令带参数(--workspace、--technique、--research)。限制披露也较好:ATT&CK 回退行为、可选 extras([mcp]、[attack])、sse 无认证均有说明。扣分点:未给出工具级参数 schema 与返回结构、无错误码与故障排查章节、无成本/额度估算、未说明语义搜索的索引与数据边界;且 MCP 相关细节大量外链,无法在本次静态可见范围内复核是否与实现一致。可用但有隐藏假设与排障缺口,判 13。
安装易用性 13/20
安装路径清晰:pip install 后 `athf init`,MCP 需 `pip install 'agentic-threat-hunting-framework[mcp]'`,并提供 `athf mcp serve --workspace` 与独立 `athf-mcp` 两种启动方式;README 给出 `~/.claude/mcp-servers.json` 的完整配置片段(command、env ATHF_WORKSPACE),属于主流客户端可直接套用的示例;另提供零安装的纯 Markdown 路径,降低前置门槛。扣分点:未提供 Copilot/Cursor 的具体配置样例、无 Windows/macOS/Linux 平台差异说明、未说明 workspace 初始化失败或路径探测冲突时的处理,且无实际启动成功证据。介于清晰与手工脆弱之间,因静态校准 setup 上限 15,判 13。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

  • 希望为威胁狩猎流程增加持久记忆与结构的安全团队
  • 使用 Claude Code、GitHub Copilot 或 Cursor 等 AI 编码助手的分析师
  • 需要将现有 PEAK/TaHiTI 流程接入 AI 工作流的组织

不适合谁

  • 需要开箱即用、带身份认证的多用户远程服务的企业
  • 期望直接替代 SIEM/EDR 平台的用户
  • 不具备本地工作区文件访问权限的环境

所需权限

  • 读取整个 ATHF 工作区文件
  • 写入/更新狩猎与研究记录
  • 部分工具会调用 LLM 智能体(产生费用)
  • 使用 sse 或 streamable-http 传输时会绑定本地端口

风险与副作用

  • sse 和 streamable-http 传输绑定到 127.0.0.1 且未经身份认证
  • 每个工具都会读取整个工作区,存在敏感狩猎数据暴露风险
  • 部分工具会调用 LLM 智能体,产生你的费用
  • 仅在明确传入 --host 时才会绑定可路由接口,此时必须前置认证代理

安装接入

准备工作

运行环境:Python 3.8+

其他可选配置项(1 个)
ATHF_WORKSPACE 可选 指定 ATHF 狩猎工作区目录路径;athf-mcp 也会从当前工作目录自动检测,非必需。
  1. 安装 MCP 依赖:pip install 'agentic-threat-hunting-framework[mcp]'。
  2. 启动 MCP 服务器:athf mcp serve --workspace /path/to/hunts。
  3. 在 ~/.claude/mcp-servers.json 中配置:{"athf":{"command":"athf-mcp","env":{"ATHF_WORKSPACE":"/path/to/your/hunts"}}}。独立的 athf-mcp 入口点会从当前工作目录或 ATHF_WORKSPACE 环境变量自动检测工作区;如需显式路径,使用 athf mcp serve --workspace /path。
.mcp.json
{"athf":{"command":"athf-mcp","env":{"ATHF_WORKSPACE":"/path/to/your/hunts"}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "athf": {
    "command": "athf-mcp",
    "env": {
      "ATHF_WORKSPACE": "/path/to/your/hunts"
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

验证是否装好

安装 agentic-threat-hunting-framework[mcp] 并启动 athf-mcp 后,在客户端工具列表中应出现该服务器暴露的 17 个工具(狩猎管理、语义搜索、ATT&CK 覆盖、研究、调查与假设生成)。

常见排障

  1. 确认已安装 [mcp] 可选依赖
  2. 检查 ATHF_WORKSPACE 环境变量或 --workspace 参数是否指向正确路径
  3. 默认 stdio 传输不开放任何套接字;若使用 sse/streamable-http 需确认端口绑定与代理配置
  4. 确认 athf-mcp 可执行文件在 PATH 中
  5. 若 ATT&CK 元数据缺失,安装 'agentic-threat-hunting-framework[attack]' 并运行 athf attack update

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 搜索我以前关于 kerberoasting 的狩猎记录
  • 统计我的狩猎库的 MITRE ATT&CK 覆盖情况
  • 查找 T1003.001 的 ATT&CK 技术元数据
  • 基于威胁情报生成新的狩猎假设

使用场景

让 AI 助手读取并回忆已记录的 LOCK 狩猎记录
在已有狩猎库中执行语义搜索与全文检索
查询 MITRE ATT&CK 覆盖度与技战术元数据
从威胁情报生成 AI 驱动的狩猎假设
管理研究文档与调查记录

支持客户端

Claude Code
GitHub Copilot
Cursor

依据项目文档列出,未经本站实测。

详细介绍

Agentic Threat Hunting Framework(ATHF)是面向威胁狩猎项目的记忆与自动化层,采用基于 Markdown 的框架,使用 LOCK 模式(Learn → Observe → Check → Keep)记录每一次狩猎,并维护可搜索的历史调查库,让 AI 助手能够引用你的环境和过往工作。ATHF 可与任意 SIEM/EDR 平台以及任意狩猎方法论(如 PEAK、TaHiTI 或自有流程)配合使用。v0.11.0 起提供 MCP 服务器,可将狩猎管理、语义搜索、ATT&CK 覆盖度、研究、调查以及 AI 驱动的假设生成等能力直接暴露给 AI 编码助手。

同类可选方案

BioMCP 75 · B

统一的命令行语法,接入约30个可信生物医学数据源。

★ 659 · 工具数 11 与当前对比 →

源版本 0ffe4db2b56d 数据同步于 2026-10-19 查看 FMRS 评分方法