Vibehacker Metasploit MCP

🚀 Vibehacker Metasploit MCP

An interface based on FastMCP for connecting to the Metasploit framework, enabling AI agents to interact with and utilize Metasploit features.

🚀 Quick Start

✅ Prerequisites

• Python 3.10+
• Metasploit framework
• uv (Python package manager)

📦 Installation

This project uses uv for dependency management. uv is a fast and reliable tool for Python package installation and resolution.

Install uv

If you haven't installed uv:

pip install uv

Project Setup

1. Clone the repository:

git clone https://github.com/foolsec/vibehacker_metasploit_mcp.git
cd vibehacker_metasploit_mcp

2. Create and activate a virtual environment using uv:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install the dependencies:

uv pip install -e .

Run the Metasploit RPC Server

Before running the application, start the Metasploit RPC server:

# Full configuration with all options
msfrpcd -P kalipassword -S -a 127.0.0.1 -p 55553

Or use a simpler command to start the RPC server on the default port (55553):

msfrpcd -P your_password

Environment Variables

Set the following environment variables:

export MSF_PASSWORD=kalipassword
export MSF_SERVER=127.0.0.1
export MSF_PORT=55553

Run the Application

python main.py

Or run the testing tool:

mcp dev main.py

✨ Features

• List available Metasploit attack modules
• List available payloads
• Generate payloads
• Run attack modules against targets
• Scan targets
• Manage active sessions
• Send commands to sessions

📄 License

For more details, please refer to the LICENSE file.