Hacking Buddy MCP

Hacking Buddy MCP is a proof-of-concept project that explores how AI can be integrated into security operations, particularly within Red Team and Pentesting workflows.

I created this tool to demonstrate practical ways in which AI can assist during offensive security engagements from reconnaissance and exploitation support to analyzing collected data. Since Red Teaming and Pentesting is where I spend most of my time, this project reflects both some of my hands-on experience and my interest in innovating with AI in the security space.

Note: This project currently includes only a few integrated tools, but I plan to add more over time as I experiment with different scenarios. My goal is to keep it fun and iterative—sharing progress as I go instead of waiting to launch a fully built-out version later.

VSCode + GitHub Copilot

This is setup including the .vscode directory which contains the mcp.json file.

• You will need to adjust the path (the last argument) in the mcp json to match your configuration.

Running the MCP server within VSCode

Running the MCP server is actually pretty easy:

1. In VSCode go to the mcp.json
2. Click Start above the JSON object, right above where it says "hacking-buddy-mcp"
   
3. Open GitHub Copilot and change it's mode to Agent
   
4. Ask it to perform one of the actions available from Hacking Buddy MCP Tools, like "Do an nmap discovery scan on this ip range 192.168.1.0/24" and "Run port scans on those hosts"

⚠ Note: If GitHub Copilot starts acting up you may need to start a new chat!

---

Setup

Pre-requisites

You need to have uv and dependencies (FastMCP) installed.

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

See uv installation guide

⚠️ It is highly recommended that you setup a virtual environment first!

1. Run uv venv to create a virtual environment
2. Run source .venv/bin/activate to active the virtual enviroment

Install dependencies from pyproject.toml

This allows you to automatically install the dependencies from a file. Run:

uv pip install -r pyproject.toml

Install dependencies manually

Install FastMCP

uv pip install fastmcp

See the FastMCP GitHub.

---

🚧 This is an experimental project, feedback and ideas are always welcome!

---