ghidraMCP

ghidraMCP هو خادم بروتوكول سياق النموذج (MCP) يسمح لنماذج اللغة الكبيرة (LLMs) بإجراء هندسة عكسية للتطبيقات بشكل مستقل. يعرض العديد من الأدوات من وظائف Ghidra الأساسية لعملاء MCP.

https://github.com/user-attachments/assets/36080514-f227-44bd-af84-78e29ee1d7f9

الميزات

خادم MCP + إضافة Ghidra

• فك التجميع وتحليل البرامج الثنائية في Ghidra
• إعادة تسمية الطرق والبيانات تلقائياً
• سرد الطرق والفئات والواردات والصادرات

التثبيت

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

• تثبيت Ghidra
• Python3
• SDK خاص بـ MCP

Ghidra

أولاً، قم بتنزيل أحدث إصدار من هذا المستودع. يحتوي على إضافة Ghidra وعميل MCP بلغة Python. ثم يمكنك استيراد الإضافة مباشرة إلى Ghidra.

1. قم بتشغيل Ghidra
2. اختر File -> Install Extensions
3. انقر على زر +
4. اختر ملف GhidraMCP-1-2.zip (أو الإصدار الذي اخترته) من الإصدار الذي تم تنزيله
5. أعد تشغيل Ghidra
6. تأكد من تمكين GhidraMCPPlugin في File -> Configure -> Developer
7. اختياري: قم بتكوين المنفذ في Ghidra من خلال Edit -> Tool Options -> GhidraMCP HTTP Server

دليل التثبيت بالفيديو:

https://github.com/user-attachments/assets/75f0c176-6da1-48dc-ad96-c182eb4648c3

عملاء MCP

نظرياً، يجب أن يعمل أي عميل MCP مع ghidraMCP. فيما يلي ثلاثة أمثلة.

المثال 1: Claude Desktop

لإعداد Claude Desktop كعميل MCP لـ Ghidra، اذهب إلى Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json وأضف ما يلي:

{
  "mcpServers": {
    "ghidra": {
      "command": "python",
      "args": [
        "/ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

بدلاً من ذلك، قم بتعديل هذا الملف مباشرة:

/Users/YOUR_USER/Library/Application Support/Claude/claude_desktop_config.json

عنوان IP والمنفذ الخاص بالخادم قابلان للتكوين ويجب ضبطهما للإشارة إلى مثيل Ghidra المستهدف. إذا لم يتم ضبطهما، فسيتم تعيينهما افتراضياً إلى localhost:8080.

المثال 2: Cline

لاستخدام GhidraMCP مع Cline، يتطلب هذا تشغيل خادم MCP يدوياً أيضاً. قم أولاً بتشغيل الأمر التالي:

python bridge_mcp_ghidra.py --transport sse --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/

الوسيطة الوحيدة الإجبارية هي النقل. إذا لم يتم تحديد جميع الوسائط الأخرى، فسيتم تعيينها افتراضياً إلى ما سبق. بمجرد تشغيل خادم MCP، افتح Cline واختر MCP Servers في الأعلى.

ثم اختر Remote Servers وأضف ما يلي، مع التأكد من أن الرابط يطابق مضيف MCP والمنفذ:

1. اسم الخادم: GhidraMCP
2. رابط الخادم: http://127.0.0.1:8081/sse

المثال 3: 5ire

عميل MCP آخر يدعم نماذج متعددة في الخلفية هو 5ire. لإعداد GhidraMCP، افتح 5ire واذهب إلى Tools -> New وضبط الإعدادات التالية:

1. مفتاح الأداة: ghidra
2. الاسم: GhidraMCP
3. الأمر: python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

البناء من المصدر

1. انسخ الملفات التالية من دليل Ghidra الخاص بك إلى دليل lib/ في هذا المشروع:

• Ghidra/Features/Base/lib/Base.jar
• Ghidra/Features/Decompiler/lib/Decompiler.jar
• Ghidra/Framework/Docking/lib/Docking.jar
• Ghidra/Framework/Generic/lib/Generic.jar
• Ghidra/Framework/Project/lib/Project.jar
• Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar
• Ghidra/Framework/Utility/lib/Utility.jar
• Ghidra/Framework/Gui/lib/Gui.jar

2. قم بالبناء باستخدام Maven عن طريق تشغيل:

mvn clean package assembly:single

الملف المضغوط الناتج يتضمن إضافة Ghidra المبنية ومواردها. هذه الملفات مطلوبة لكي يتعرف Ghidra على الإضافة الجديدة.

• lib/GhidraMCP.jar
• extensions.properties
• Module.manifest