Hacktricks MCP Server

🚀 HackTricks MCP 服务器

HackTricks MCP（模型上下文协议）服务器可让你直接通过 Claude 搜索和查询 HackTricks 渗透测试文档。它为渗透测试人员提供了便捷的方式，能快速获取所需的技术信息和利用方法。

✨ 主要特性

• 快速查找：支持别名（如 sqli、xss、ssrf 等），一键获取利用信息。
• 分组搜索结果：搜索结果按文件分组，显示匹配数量、标题和相关章节。
• 页面大纲：提供快速目录，便于识别相关章节。
• 章节提取：可读取特定章节，而非完整页面，节省令牌。
• 速查表模式：仅提取页面中的代码块和命令。
• 类别浏览：可查看可用主题和文件路径。
• 快速 grep 搜索：使用 ripgrep 实现即时搜索结果。
• 安全加固：防止命令注入和路径遍历攻击。

🚀 快速开始

📦 安装指南

使用 npm 全局安装

npm install -g hacktricks-mcp-server

安装后脚本会自动克隆 HackTricks 仓库（首次安装约需 2 分钟）。

配置 Claude 桌面版

在你的 Claude 设置文件（~/.claude/settings.json）中添加以下内容：

{
  "mcpServers": {
    "hacktricks": {
      "command": "npx",
      "args": ["hacktricks-mcp-server"]
    }
  }
}

重启 Claude 桌面版，然后尝试输入："Search HackTricks for SQL injection"

从源代码安装

git clone https://github.com/Xplo8E/hacktricks-mcp-server.git
cd hacktricks-mcp-server
git submodule update --init --recursive
npm install
npm run build

源代码安装的配置：

{
  "mcpServers": {
    "hacktricks": {
      "command": "node",
      "args": ["/absolute/path/to/hacktricks-mcp-server/dist/index.js"]
    }
  }
}

💻 使用示例

在 Claude 桌面版中配置好后，你可以提出以下问题：

• "Search HackTricks for SQL injection techniques"
• "Give me SUID privilege escalation commands"
• "Show me XSS payloads"
• "List all pentesting categories in HackTricks"
• "How do I exploit XXE vulnerabilities?"

该服务器提供了 7 种专用工具，可高效搜索 HackTricks 文档。

可用工具

hacktricks_quick_lookup

⚡ 一键利用查找。通过一次调用，搜索并找到最佳页面，返回利用章节和代码块。

参数：

• topic（字符串，必需）：要查找的攻击或技术（如 'SUID'、'sqli'、'xss'、'docker escape'）
• category（字符串，可选）：类别过滤器，用于更快地获取结果

支持的别名：sqli、xss、rce、lfi、rfi、ssrf、csrf、xxe、ssti、idor、jwt、suid、privesc

示例：

hacktricks_quick_lookup("SSRF", category="pentesting-web")

优点：将 "如何利用 X" 这类问题所需的 3 次以上工具调用减少为 1 次。

search_hacktricks

搜索 HackTricks 文档。返回按文件分组的结果，包含匹配数量、页面标题和相关章节标题。

参数：

• query（字符串，必需）：搜索词或正则表达式模式
• category（字符串，可选）：过滤到特定类别（如 'pentesting-web'）
• limit（数字，可选）：最大分组结果数（默认：20）

示例输出：

Found matches in 5 files for: "SUID"

────────────────────────────────────────────────────────────

📄 **Linux Privilege Escalation**
   Path: src/linux-hardening/privilege-escalation/README.md
   Matches: 12
   Sections: SUID Binaries | Finding SUID | GTFOBins
   Preview:
     L45: Find files with SUID bit set...
     L78: Common SUID exploitation techniques...

────────────────────────────────────────────────────────────

get_hacktricks_outline

获取页面的目录（所有章节标题）。在读取完整页面之前使用此工具，以了解页面结构。

参数：

• path（字符串）：Markdown 文件的相对路径

示例输出：

# Linux Privilege Escalation
  ## Enumeration
    ### System Information
    ### Network
  ## SUID Binaries
    ### Finding SUID Files
    ### Exploiting SUID
  ## Capabilities

优点：只需约 20 行即可查看页面结构，而无需读取 500 多行内容。

get_hacktricks_section

按标题名称从页面中提取特定章节。这比读取完整页面更高效。

参数：

• path（字符串）：Markdown 文件的相对路径
• section（字符串）：要提取的章节标题（部分匹配，不区分大小写）

示例：

get_hacktricks_section("src/linux-hardening/privilege-escalation/README.md", "SUID")

优点：只需读取 "SUID Binaries" 章节（约 200 个令牌），而不是整个页面（约 3000 个令牌）。

get_hacktricks_cheatsheet

从页面中仅提取代码块。当你只需要命令、有效负载或示例时，这是最佳选择。

参数：

• path（字符串）：Markdown 文件的相对路径

示例输出：

find / -perm -4000 2>/dev/null

./vulnerable_suid -p

优点：当你只需要 "给我命令" 时，可以跳过解释性文本。

get_hacktricks_page

获取 HackTricks 页面的完整内容。

参数：

• path（字符串）：Markdown 文件的相对路径

警告：页面可能非常长（3000 多个令牌）。建议考虑使用 get_hacktricks_outline + get_hacktricks_section 代替。

list_hacktricks_categories

列出类别及其内容。

参数：

• category（字符串，可选）：要展开的类别

不指定类别：列出顶级类别 指定类别：显示带有文件路径的完整目录树

🔧 高效使用模式

为了优化令牌使用，Claude 应按以下步骤操作：

1. 使用类别过滤器进行搜索 → 获取带有上下文的分组结果
2. 获取相关页面的大纲 → 在读取之前了解结构
3. 提取特定章节 → 仅读取所需内容
4. 获取速查表 → 快速参考命令

之前（低效）：

search_hacktricks("SUID")     → 50 行原始结果
get_page(file1)               → 3000 个令牌
get_page(file2)               → 2500 个令牌  
总计：约 5500 个令牌，3 次调用

之后（高效）：

search_hacktricks("SUID", category="linux-hardening")  → 分组结果
get_outline(best_match)                                 → 20 行
get_section(best_match, "SUID")                         → 200 个令牌
总计：约 400 个令牌，3 次调用

📚 详细文档

要求

• Node.js（v18 或更高版本）
• ripgrep (rg) - 通常在 macOS/Linux 上预先安装
• Bun（用于包管理）

开发

监视模式：

bun run dev

本地测试：

bun run start

贡献

欢迎贡献代码！如果你想改进服务器：

1. 分叉仓库
2. 创建功能分支（git checkout -b feature/improvement）
3. 进行更改并在本地测试
4. 提交拉取请求

请确保你的拉取请求包含新功能的测试，并保持现有代码风格。

📄 许可证

本项目采用 MIT 许可证。

致谢

• HackTricks 由 Carlos Polop 开发
• 使用 Model Context Protocol SDK 构建