mcpField
H
hacktricks-mcp

hacktricks-mcp

本地服务
github.com/zebbern安全31 天前更新

关于 hacktricks-mcp

hacktricks-mcp 是只读 MCP 服务,用于搜索和读取 HackTricks 攻防安全维基内容。内置 SQLite FTS5 索引支持离线查询,无需克隆维基或在查询时联网。

主要功能

  1. 01离线全文搜索维基
  2. 02返回排序结果和片段
  3. 03分类筛选与缩写识别
  4. 04读取页面、章节或代码块
  5. 05浏览维基目录树

适用场景

  1. 01授权安全测试时搜索 HackTricks
  2. 02查找特定章节或代码块
  3. 03通过缩写定位主题

MCP 相关

它向 MCP 客户端提供只读搜索、页面读取和目录工具。内置索引每三天与上游同步一次。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"zebbern-hacktricks": {
"command": "npx",
"args": [
"-y",
"@zebbern/hacktricks-mcp"
]
}
}
}
启动命令npx -y @zebbern/hacktricks-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@zebbern/hacktricks-mcp0.1.5

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
limitinteger否结果数量上限(默认值为 10)
querystring是搜索词,例如 'docker escape' 或 'asreproast'
categorystring否可选类别筛选器(子字符串匹配),例如 'Windows Hardening' 或 'Pentesting Web'

详细介绍

hacktricks-mcp

为 AI Agent 提供 MCP 服务,可快速离线搜索并按章节检索 HackTricks 攻防安全维基的全文内容。

与基于 grep 的替代方案不同,此服务在软件包中内置了预构建的 SQLite FTS5 搜索索引(1,000 多个页面)。安装时无需克隆仓库,无需依赖 ripgrep,查询时也无需访问网络。GitHub Action 每 3 天与上游同步一次索引,并将其提交回此仓库。

快速开始

要求:Node.js 22.13 或更高版本(使用内置的 node:sqlite,无需原生依赖)。

Claude Code:

claude mcp add hacktricks -- npx -y @zebbern/hacktricks-mcp

Codex CLI:

codex mcp add hacktricks -- npx -y @zebbern/hacktricks-mcp

任何 MCP 客户端(Claude Desktop、Cursor、Kimi 等),配置 JSON:

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

作为插件使用(附带用于讲解高效使用方法的 Agent 技能):此仓库是适用于 Claude Code(.claude-plugin/)、Codex(.codex-plugin/)和 Kimi(kimi-plugin/)的有效插件。可在客户端的插件市场中添加 zebbern/hacktricks-mcp,或在 Kimi Work 中使用此插件链接。

然后可以提出如下问题:

  • “在 HackTricks 中搜索 kerberoast,并提供攻击命令”
  • “如何从 lxd 组提升权限?”
  • “显示 pentesting-web 页面中的 SSRF 章节”

工具一览

工具功能
hacktricks_search排序后的全文搜索,支持摘要、类别筛选和缩写处理(privesc、sqli、rce 等)
hacktricks_get_page阅读页面、单个章节或仅代码块
hacktricks_get_toc维基类别树,方便 Agent 查看主题所在位置

所有工具均为只读。完整参考:docs/tools.md。

文档

安全与法律

  • 此服务不会执行维基中的任何内容;它是一个只读搜索接口。所有查询均使用参数化处理,且会在构造查询前转义用户输入。
  • HackTricks 内容是攻防安全参考资料。仅可用于测试你获准测试的系统。
  • 内容归 HackTricks / Carlos Polop 及贡献者所有;此仓库包含衍生的索引数据和原创服务代码(MIT)。

致谢

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。