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 構建