关于 hacktricks-mcp
hacktricks-mcp 是只读 MCP 服务,用于搜索和读取 HackTricks 攻防安全维基内容。内置 SQLite FTS5 索引支持离线查询,无需克隆维基或在查询时联网。
主要功能
- 01离线全文搜索维基
- 02返回排序结果和片段
- 03分类筛选与缩写识别
- 04读取页面、章节或代码块
- 05浏览维基目录树
适用场景
- 01授权安全测试时搜索 HackTricks
- 02查找特定章节或代码块
- 03通过缩写定位主题
MCP 相关
它向 MCP 客户端提供只读搜索、页面读取和目录工具。内置索引每三天与上游同步一次。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 结果数量上限(默认值为 10) |
| query | string | 是 | 搜索词,例如 'docker escape' 或 'asreproast' |
| category | string | 否 | 可选类别筛选器(子字符串匹配),例如 '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。
文档
- docs/tools.md:完整的工具参考,包含参数和示例
- docs/architecture.md:索引和 3 天同步机制的工作方式
- docs/development.md:本地设置、测试和发布
- docs/agents.md:Agent 技能、MCP 注册表和插件打包
安全与法律
- 此服务不会执行维基中的任何内容;它是一个只读搜索接口。所有查询均使用参数化处理,且会在构造查询前转义用户输入。
- HackTricks 内容是攻防安全参考资料。仅可用于测试你获准测试的系统。
- 内容归 HackTricks / Carlos Polop 及贡献者所有;此仓库包含衍生的索引数据和原创服务代码(MIT)。
致谢
- Carlos Polop 及贡献者编写的 HackTricks
- Model Context Protocol SDK
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。