Skip to content
Back to search

BloodHound-MCP-AI

BloodHound-MCP-AI is integration that connects BloodHound with AI through Model Context Protocol, allowing security professionals to analyze Active Directory attack paths using natural language instead of complex Cypher queries.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mordavid--bloodhound-mcp-ai/badge.svg)](/listings/mordavid--bloodhound-mcp-ai)

HTML

<a href="/listings/mordavid--bloodhound-mcp-ai"><img src="/api/listings/mordavid--bloodhound-mcp-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Clone this repository:

   git clone https://github.com/your-username/MCP-BloodHound.git
   cd MCP-BloodHound

2. Install dependencies:

   pip install -r requirements.txt

3. Configure the MCP Server ```bash "mcpServers": { "BloodHound-MCP": { "command": "python", "args": [ "<Your_Path>\\BloodHound-MCP.py" ], "env": { "BLOODHOUND_URI": "bolt://localhost:7687", "BLOODHOUND_USERNAME": "neo4j", "BLOODHOUND_PASSWORD": "bloodhoundcommunityedition" } } }

## πŸš€ Usage

Example queries you can ask through the MCP:

- "Show me all paths from kerberoastable users to Domain Admins"
- "Find computers where Domain Users have local admin rights"
- "Identify Domain Controllers vulnerable to NTLM relay attacks"
- "Map all Active Directory certificate services vulnerabilities"
- "Generate a comprehensive security report for my domain"
- "Find inactive privileged accounts"
- "Show me attack paths to high-value targets"

## πŸ” Security Considerations

This tool is designed for legitimate security assessment purposes. Always:
- Obtain proper authorization before analyzing any Active Directory environment
- Handle BloodHound data as sensitive information
- Follow responsible disclosure practices for any vulnerabilities discovered

## πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

## πŸ™ Acknowledgments

- The BloodHound team for creating an amazing Active Directory security tool
- The security community for continuously advancing AD security practices

[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/09d13f50-8965-4ebf-b4bf-d6bb98e8f092)

---

*Note: This is not an official Anthropic product. BloodHound-MCP is a community-driven integration between BloodHound and MCP.* 

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 114 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # BloodHound-MCP
  2. ![BloodHound-MCP](/images/BloodHound-MCP-Banner.png)
  3. ## Model Context Protocol (MCP) Server for BloodHound
  4. BloodHound-MCP is a powerful integration that brings the capabilities of Model Context Procotol (MCP) Server to BloodHound, the industry-standard tool for Active Directory security analysis. This integration allows you to analyze BloodHound data using natural language, making complex Active Directory attack path analysis accessible to everyone.
  5. > πŸ₯‡ **First-Ever BloodHound AI Integration!**
  6. > This is the first integration that connects BloodHound with AI through MCP, [originally announced here](https://www.linkedin.com/posts/mor-david-cyber_bloodhound-ai-cybersec-activity-7310921541213470721-N390).
  7. ## πŸ” What is BloodHound-MCP?
  8. BloodHound-MCP combines the power of:
  9. - **BloodHound**: Industry-standard tool for visualizing and analyzing Active Directory attack paths
  10. - **Model Context Protocol (MCP)**: An open protocol for creating custom AI tools, compatible with various AI models
  11. - **Neo4j**: Graph database used by BloodHound to store AD relationship data
  12. With over 75 specialized tools based on the original BloodHound CE Cypher queries, BloodHound-MCP allows security professionals to:
  13. - Query BloodHound data using natural language
  14. - Discover complex attack paths in Active Directory environments
  15. - Assess Active Directory security posture more efficiently
  16. - Generate detailed security reports for stakeholders
  17. ## πŸ“± Community
  18. Join our Telegram channel for updates, tips, and discussion:
  19. - **Telegram**: [root_sec](https://t.me/root_sec)
  20. ## 🌟 Star History
  21. [![Star History Chart](https://api.star-history.com/svg?repos=MorDavid/BloodHound-MCP-AI&type=Date)](https://www.star-history.com/#MorDavid/BloodHound-MCP-AI&Date)
  22. ## ✨ Features
  23. - **Natural Language Interface**: Query BloodHound data using plain English
  24. - **Comprehensive Analysis Categories**:
  25. - Domain structure mapping
  26. - Privilege escalation paths
  27. - Kerberos security issues (Kerberoasting, AS-REP Roasting)
  28. - Certificate services vulnerabilities
  29. - Active Directory hygiene assessment
  30. - NTLM relay attack vectors
  31. - Delegation abuse opportunities
  32. - And much more!
  33. ## πŸ“‹ Prerequisites
  34. - BloodHound 4.x+ with data collected from an Active Directory environment
  35. - Neo4j database with BloodHound data loaded
  36. - Python 3.8 or higher
  37. - MCP Client
  38. ## πŸ”§ Installation
  39. 1. Clone this repository:
  40. ```bash
  41. git clone https://github.com/your-username/MCP-BloodHound.git
  42. cd MCP-BloodHound
  43. ```
  44. 2. Install dependencies:
  45. ```bash
  46. pip install -r requirements.txt
  47. ```
  48. 3. Configure the MCP Server
  49. ```bash
  50. "mcpServers": {
  51. "BloodHound-MCP": {
  52. "command": "python",
  53. "args": [
  54. "<Your_Path>\\BloodHound-MCP.py"
  55. ],
  56. "env": {
  57. "BLOODHOUND_URI": "bolt://localhost:7687",
  58. "BLOODHOUND_USERNAME": "neo4j",
  59. "BLOODHOUND_PASSWORD": "bloodhoundcommunityedition"
  60. }
  61. }
  62. }
  63. ```
  64. ## πŸš€ Usage
  65. Example queries you can ask through the MCP:
  66. - "Show me all paths from kerberoastable users to Domain Admins"
  67. - "Find computers where Domain Users have local admin rights"
  68. - "Identify Domain Controllers vulnerable to NTLM relay attacks"
  69. - "Map all Active Directory certificate services vulnerabilities"
  70. - "Generate a comprehensive security report for my domain"
  71. - "Find inactive privileged accounts"
  72. - "Show me attack paths to high-value targets"
  73. ## πŸ” Security Considerations
  74. This tool is designed for legitimate security assessment purposes. Always:
  75. - Obtain proper authorization before analyzing any Active Directory environment
  76. - Handle BloodHound data as sensitive information
  77. - Follow responsible disclosure practices for any vulnerabilities discovered
  78. ## πŸ“œ License
  79. This project is licensed under the MIT License - see the LICENSE file for details.
  80. ## πŸ™ Acknowledgments
  81. - The BloodHound team for creating an amazing Active Directory security tool
  82. - The security community for continuously advancing AD security practices
  83. [![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/09d13f50-8965-4ebf-b4bf-d6bb98e8f092)
  84. ---
  85. *Note: This is not an official Anthropic product. BloodHound-MCP is a community-driven integration between BloodHound and MCP.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.