BloodHound-MCP

No description

GitHub Stars

153

User Rating

Not Rated

Favorites

0

Views

38

Forks

14

Issues

0

Installation
Difficulty
Beginner
Estimated Time
5-10 minutes

Installation

Installation

Prerequisites

Required software and versions:
Python: 3.8 or higher
Neo4j: 4.0 or higher

Installation Steps

1. Clone Repository

bash
git clone https://github.com/stevenyu113228/BloodHound-MCP.git
cd BloodHound-MCP

2. Install Dependencies

bash
pip install -r requirements.txt

3. Configure MCP Server

Edit mcp_config.json to add the MCP server:
json
{
  "mcpServers": {
    "BloodHound": {
      "name": "BloodHound",
      "isActive": true,
      "command": "uv",
      "args": ["run", "--with", "mcp[cli],neo4j", "mcp", "run", "server.py"],
      "env": {
        "BLOODHOUND_URI": "bolt://localhost:7687",
        "BLOODHOUND_USERNAME": "neo4j",
        "BLOODHOUND_PASSWORD": "bloodhound"
      }
    }
  }
}

4. Start Server

bash
uvicorn mcp/run:app --reload

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Neo4j connection settings and ensure you are using the correct credentials. Issue: Queries are not executing correctly Solution: Verify the syntax of the queries and ensure the necessary data exists in Neo4j.

Additional Resources