What is Hackermcp

HackerMCP is a module designed for AI assistants to access and utilize common penetration testing and security tools, allowing AI systems to leverage powerful security tools through a simple interface.

Use cases

Use cases for HackerMCP include automating penetration testing processes, enhancing security assessments, and providing AI-driven insights into network vulnerabilities.

How to use

To use HackerMCP, add the specified configuration to your MCP configuration file, set up a virtual environment, and install the necessary dependencies. Ensure that Python 3.8 or higher, Nmap, and Metasploit Framework are installed on your system.

Key features

Key features of HackerMCP include support for tools like Nmap for network discovery and security auditing, and Metasploit Framework for penetration testing. Future goals include adding support for SQLMap and expanding the range of available security tools.

Where to use

HackerMCP can be used in cybersecurity, penetration testing, and security auditing fields, providing AI systems with the ability to perform security assessments effectively.

HackerMCP

HackerMCP is a module built for AI assistants to access and utilize common penetration testing and security tools. This module enables AI systems to leverage powerful security tools through a simple interface.

Currently Supported Tools

• Nmap: Network discovery and security auditing
• Metasploit Framework: Penetration testing framework

Future Goals

• Add support for SQLMap
• Expand available security tools and capabilities

Installation

Add the following configuration to your MCP configuration file:

{
  "mcpServers": {
    "hackermcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/dir/to/hackermcp",
        "run",
        "hacker.py"
      ]
    }
  }
}

Replace ~/dir/to/hackermcp with the actual path to the hackermcp directory.

Environment Setup

Prerequisites

• Python 3.8 or higher
• Nmap installed on your system
• Metasploit Framework installed on your system

Virtual Environment Setup

1. Clone the repository:

   git clone https://github.com/R3verseIN/HackerMCP
   cd HackerMCP
   

2. Set up a virtual environment using uv:

   uv venv
   source .venv/bin/activate
   

3. Install dependencies:

   uv pip install -r requirements.txt
   

Installing UV

If you don’t have the uv package manager then install it:

pip3 install uv

Or use curl to download the installation script:

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

If your system doesn’t have curl, you can use wget:

wget -qO- https://astral.sh/uv/install.sh | sh

Disclaimer

This tool is provided for educational and legitimate security testing purposes only.

No warranty is provided with this software. The creator is not responsible for any unethical or illegal use of this tool. Users are solely responsible for ensuring they have proper authorization before conducting any security testing activities.

License

GNU GPL v3 License