Bloodyad MCP

🚀 bloodyad - mcp

このプロジェクトは、優れた bloodyAD ツールのラッパーです。 Model Context Protocol (MCP) サーバーとして機能し、bloodyAD をラッピングし、Claude Desktop、Gemini - CLI、またはその他の MCP フロントエンドから、柔軟かつ自動的に Active Directory の列挙と悪用を行うことができます。

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

🚀 クイックスタート

このサーバーは、簡単な Python 関数を通じて bloodyAD コマンドを公開し、AI アシスタントまたは MCP 環境から直接 Active Directory オブジェクトの列挙、抽出、および悪用を容易にします。これにより、bloodyAD CLI を手動で実行する必要がなくなります。

✨ 主な機能

取得操作

• bloodyad_raw — 任意の bloodyAD コマンドを文字列として実行します（最大の柔軟性、高度なモード）。
• bloodyad_get_object — LDAP オブジェクトの属性を取得し、SD を解決するオプションがあります。
• bloodyad_get_children — オブジェクトの子（ユーザー、グループ、コンピューター、OU）をリストします。
• 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 — オブジェクト上のサービスに Resource Based Constrained Delegation (RBCD) を追加します。
• bloodyad_add_shadowCredentials — オブジェクトに Key Credentials (Shadow Credentials) を追加します。
• bloodyad_add_uac — オブジェクトに User Account Control (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 — サービスの Resource Based Constrained Delegation (RBCD) を削除します。
• bloodyad_remove_shadowCredentials — オブジェクトから Key Credentials (Shadow Credentials) を削除します。
• bloodyad_remove_uac — オブジェクトから User Account Control (UAC) フラグを削除します。

📦 インストール

始める前に、以下が必要です。

• Docker Desktop：システムにインストールされ、実行中であること。
• MCP Toolkit：Docker Desktop 内で有効になっていること。
• AI アシスタント：MCP をサポートする AI アシスタント（Gemini - CLI または Claude Desktop など）。
• インターネットアクセス：Docker イメージのビルド中に bloodyAD をクローンするために必要です。
• VPN/ネットワークアクセス：ターゲットの Active Directory Domain Controller (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 などで起動することができます。

基本的な使用法

# Get bloodyAD help
print(default_api.bloodyad_raw(cli_args="-h"))

# Get object attributes (e.g., objectSid of the domain)
print(default_api.bloodyad_get_object(target='DC=fluffy,DC=htb', attr='objectSid', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# List child objects of a domain
print(default_api.bloodyad_get_children(target='DC=fluffy,DC=htb', otype='domain', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# Dump DNS records for a zone
print(default_api.bloodyad_get_dnsdump(zone='fluffy.htb', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# Get group memberships for a user
print(default_api.bloodyad_get_membership(target='svc_mssql', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# List writable objects for the authenticated user
print(default_api.bloodyad_get_writable(user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

# Perform an advanced LDAP search
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'))

# Change a user's password
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'))

# Add a new user
print(default_api.bloodyad_add_user(samAccountName='NewUser', newpass='NewUserPass123!', user='fluffy.htb\svc_mssql', password='MssqlService01!', host='dc01.fluffy.htb'))

📚 ドキュメント

AI Assistant (Gemini - CLI/Claude Desktop) → MCP Gateway → bloodyad - mcp → bloodyAD CLI (Kali)

🔧 トラブルシューティング

• ツールが表示されない場合は、ビルド、ログ、YAML ファイル（custom.yaml、registry.yaml）を確認し、AI アシスタントを再起動してください。
• bloodyAD コマンドが失敗した場合は、引数（ホスト、ドメイン、ユーザー、パスワード）、VPN、ターゲットマシンへの到達可能性、および bloodyAD のバージョンを確認してください。

🔒 セキュリティに関する考慮事項

• 資格情報は各コマンドとともに渡され、保存またはログに記録されません。
• サーバーは Docker 内で非ルートユーザーとして実行されます。
• 出力は、bloodyAD と同じ平文で、絵文字や追加の Markdown 形式はありません。

📄 ライセンス

MIT License