Bloodyad MCP

🚀 bloodyad-mcp

bloodyad-mcp 是優秀工具 bloodyAD 的包裝器。它是一個模型上下文協議（MCP）服務器，作為 bloodyAD 的包裝器，允許從 Claude Desktop、Gemini-CLI 或其他 MCP 前端靈活自動地進行 Active Directory 枚舉和利用。

README (English) | 中文文檔 (Chinese) | README en Español

🚀 快速開始

項目目的

此服務器通過簡單的 Python 函數公開 bloodyAD 命令，便於直接從 AI 助手或 MCP 環境中對 Active Directory 對象進行枚舉、提取和利用，無需手動執行 bloodyAD 命令行界面。

✨ 主要特性

獲取操作

• bloodyad_raw — 以字符串形式執行任何 bloodyAD 命令（最大靈活性，高級模式）。
• bloodyad_get_object — 檢索 LDAP 對象屬性，可選擇解析 SD。
• bloodyad_get_children — 列出對象的子項（用戶、組、計算機、組織單位）。
• bloodyad_get_dnsdump — 提取與 AD 集成的 DNS 區域。
• bloodyad_get_membership — 獲取目標所屬的組。
• bloodyad_get_writable — 列出經過身份驗證的用戶具有寫入權限的對象。
• bloodyad_get_search — 在 LDAP 數據庫中執行高級搜索。
• bloodyad_get_trusts — 以 ASCII 樹形式顯示域信任關係。

設置操作

• bloodyad_set_object — 添加/替換/刪除對象的屬性。
• bloodyad_set_owner — 更改對象的所有者。
• bloodyad_set_password — 更改用戶/計算機的密碼。
• bloodyad_set_restore — 恢復已刪除的對象。

添加操作

• bloodyad_add_computer — 添加新計算機。
• bloodyad_add_dcsync — 為域中的受託人添加 DCSync 權限。
• bloodyad_add_dnsRecord — 添加新的 DNS 記錄。
• bloodyad_add_genericAll — 授予受託人對對象的完全控制權（GenericAll）。
• bloodyad_add_groupMember — 將成員（用戶、組、計算機）添加到組中。
• bloodyad_add_rbcd — 為對象上的服務添加基於資源的約束委派（RBCD）。
• bloodyad_add_shadowCredentials — 為對象添加密鑰憑證（Shadow Credentials）。
• bloodyad_add_uac — 為對象添加用戶賬戶控制（UAC）標誌。
• bloodyad_add_user — 添加新用戶。

刪除操作

• bloodyad_remove_dcsync — 移除受託人對 DCSync 的權限。
• bloodyad_remove_dnsRecord — 從 AD 環境中移除 DNS 記錄。
• bloodyad_remove_genericAll — 移除受託人對對象的完全控制權（GenericAll）。
• bloodyad_remove_groupMember — 從組中移除成員。
• bloodyad_remove_object — 移除對象（用戶、組、計算機、組織單位等）。
• bloodyad_remove_rbcd — 移除服務的基於資源的約束委派（RBCD）。
• bloodyad_remove_shadowCredentials — 從對象中移除密鑰憑證（Shadow Credentials）。
• bloodyad_remove_uac — 從對象中移除用戶賬戶控制（UAC）標誌。

📦 安裝指南

前提條件

在開始之前，請確保具備以下條件：

• Docker Desktop：已安裝並在系統上運行。
• MCP 工具包：在 Docker Desktop 中啟用。
• AI 助手：支持 MCP 的 AI 助手，如 Gemini-CLI 或 Claude Desktop。
• 互聯網訪問：在 Docker 鏡像構建過程中需要訪問互聯網以克隆 bloodyAD。
• VPN/網絡訪問：能夠訪問目標 Active Directory 域控制器（DC）。
• jq（適用於 Linux 用戶）：輕量級且靈活的命令行 JSON 處理器。如果使用 Linux，可能需要安裝它：
  • Debian/Ubuntu：sudo apt-get install jq
  • Fedora：sudo dnf install jq
  • Arch Linux：sudo pacman -S jq

安裝步驟

點擊圖片觀看安裝教程視頻。

按照以下步驟設置並運行 bloodyad-mcp 服務器：

1. 克隆倉庫：

git clone https://github.com/dcollaoa/bloodyad_mcp.git
cd bloodyad-mcp

2. 運行設置腳本： 執行適合你操作系統的腳本。這些腳本將構建 Docker 鏡像、配置 MCP 目錄並更新你的 Gemini 設置。
   • Windows 用戶：

.\run.ps1

此腳本將指導你完成 Docker 鏡像構建、MCP 配置和 Gemini settings.json 更新。 - Linux（或 WSL）用戶：

chmod +x run.sh
./run.sh

此腳本將執行與 PowerShell 腳本相同的設置步驟。請先使其可執行。 - macOS 用戶：

chmod +x run_macos.sh
./run_macos.sh

此腳本將執行與 PowerShell 腳本相同的設置步驟，適用於 macOS。請先使其可執行。

💻 使用示例

基礎用法

你可以在 Claude Desktop、Gemini-CLI 等中啟動以下操作：

# 獲取 bloodyAD 幫助
print(default_api.bloodyad_raw(cli_args="-h"))

# 獲取對象屬性（例如，域的 objectSid）
print(default_api.bloodyad_get_object(target='DC=fluffy,DC=htb', attr='objectSid', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# 列出域的子對象
print(default_api.bloodyad_get_children(target='DC=fluffy,DC=htb', otype='domain', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# 轉儲區域的 DNS 記錄
print(default_api.bloodyad_get_dnsdump(zone='fluffy.htb', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# 獲取用戶的組成員身份
print(default_api.bloodyad_get_membership(target='svc_mssql', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# 列出經過身份驗證的用戶可寫入的對象
print(default_api.bloodyad_get_writable(user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# 執行高級 LDAP 搜索
print(default_api.bloodyad_get_search(base='DC=fluffy,DC=htb', filter='(objectClass=user)', attr='sAMAccountName', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# 更改用戶密碼
print(default_api.bloodyad_set_password(target='CN=TestUser,CN=Users,DC=fluffy,DC=htb', newpass='NewSecurePassword123!', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# 添加新用戶
print(default_api.bloodyad_add_user(samAccountName='NewUser', newpass='NewUserPass123!', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

📚 詳細文檔

架構

AI 助手 (Gemini-CLI/Claude Desktop) → MCP 網關 → bloodyad-mcp → bloodyAD 命令行界面 (Kali)

故障排除

• 如果工具未顯示：檢查構建、日誌、YAML 文件（custom.yaml、registry.yaml），並重啟 AI 助手。
• 如果 bloodyAD 命令失敗：檢查參數（主機、域、用戶、密碼）、VPN、目標機器的可達性以及 bloodyAD 版本。

安全注意事項

• 每個命令都會傳遞憑據，但不會存儲或記錄。
• 服務器在 Docker 中以非根用戶身份運行。
• 輸出為純文本，與 bloodyAD 的輸出相同，無表情符號或額外的 Markdown 格式。

📄 許可證

本項目採用 MIT 許可證。