HackerMCP

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

-
security - not tested
-
license - not tested
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A module that enables AI assistants to access and utilize common penetration testing and security tools like Nmap and Metasploit through a simple interface.

  1. Currently Supported Tools
    1. Future Goals
      1. Installation
        1. Environment Setup
          1. Prerequisites
          2. Virtual Environment Setup
          3. Installing UV
        2. Disclaimer
          1. License

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Enables AI assistants to perform network scanning operations using NMAP, offering a standardized interface for network analysis and security assessments through AI conversations.
              Last updated -
              11
              3
              JavaScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A FastMCP-based interface for Metasploit Framework, enabling AI agents to interact with Metasploit capabilities for exploitation, payload generation, target scanning, and session management.
              Last updated -
              Python
              Apache 2.0
              • Linux
              • Apple
            • -
              security
              F
              license
              -
              quality
              An integration that enables AI assistants to interact with network data through a standardized protocol, providing AI-ready tools and interfaces for network automation and management.
              Last updated -
              2
              Python
            • -
              security
              A
              license
              -
              quality
              Provides a bridge between large language models and the Metasploit Framework, enabling AI assistants to access and control penetration testing functionality through natural language.
              Last updated -
              12
              Python
              Apache 2.0
              • Linux
              • Apple

            View all related MCP servers

            ID: juc4kbdv9s