Vibehacker Metasploit MCP

by foolsec

Integrations

  • Enables repository cloning from GitHub as part of the setup process.

  • Provides a comprehensive interface to Metasploit Framework capabilities, enabling listing of exploits and payloads, payload generation, target exploitation, vulnerability scanning, and management of active sessions including command execution.

Vibehacker Metasploit MCP

A FastMCP-based interface for Metasploit Framework, enabling AI agents to interact with Metasploit capabilities.

Prerequisites

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

Setup with uv

This project uses uv for dependency management. uv is a fast, reliable Python package installer and resolver.

Installing uv

If you don't have uv installed:

pip install uv

Setting up the project

  1. Clone the repository:
git clone https://github.com/foolsec/vibehacker_metasploit_mcp.git cd vibehacker_metasploit_mcp
  1. Create and activate a virtual environment with uv:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
  1. Install dependencies:
uv pip install -e .

Running 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 the simpler command to start the RPC server in the background 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

Running the Application

python main.py

or to test the tools

mcp dev main.py

Features

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

License

See the LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

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

A FastMCP-based interface for Metasploit Framework, enabling AI agents to interact with Metasploit capabilities for exploitation, payload generation, target scanning, and session management.

  1. Prerequisites
    1. Setup with uv
      1. Installing uv
      2. Setting up the project
      3. Running Metasploit RPC Server
      4. Environment Variables
      5. Running the Application
    2. Features
      1. License

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          MCP server enabling AI agents to programmatically connect to and control Apache Superset instances, allowing users to manage dashboards, charts, databases, datasets, and run SQL queries through natural language interactions.
          Last updated -
          20
          Python
          MIT License
        • -
          security
          A
          license
          -
          quality
          An MCP server that extends AI agents' context window by providing tools to store, retrieve, and search memories, allowing agents to maintain history and context across long interactions.
          Last updated -
          5
          TypeScript
          MIT License
        • -
          security
          A
          license
          -
          quality
          An MCP-compliant server that enables AI systems to interact with mobile and desktop applications through Frida's dynamic instrumentation capabilities, allowing for process management, device control, JavaScript execution, and script injection.
          Last updated -
          2
          Python
          MIT License
          • Linux
          • Apple
        • -
          security
          -
          license
          -
          quality
          A modular dynamic API server based on the MCP protocol that provides rich tool capabilities for AI assistants while significantly reducing prompt token consumption.
          Last updated -
          TypeScript

        View all related MCP servers

        ID: an46g2am4i