ghidra_MCP_logo

ghidraMCP

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

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

الميزات

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

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

التثبيت

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

ثبّت Ghidra 12.1.4
ثبّت uv (أو Python 3.10+ مع pip install git+https://github.com/LaurieWired/GhidraMCP، ثم استخدم ghidra-mcp كأمر كما هو موضح أدناه)

Ghidra

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

شغّل Ghidra
اختر File -> Install Extensions
انقر على زر +
اختر ghidra_12.1.4_PUBLIC_<date>_GhidraMCP.zip من الإصدار الذي تم تنزيله
أعد تشغيل Ghidra
تأكد من تمكين GhidraMCPPlugin في File -> Configure -> Developer
اختياري: اضبط المنفذ في Ghidra عبر Edit -> Tool Options -> GhidraMCP HTTP Server

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

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

عملاء MCP

من الناحية النظرية، يجب أن يعمل أي عميل MCP مع ghidraMCP. تقبل معظم العملاء ملف إعداد JSON مثل التالي:

{
  "mcpServers": {
    "ghidra": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/LaurieWired/GhidraMCP",
        "ghidra-mcp",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

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

بالنسبة للعملاء الذين يتصلون بعنوان URL بدلًا من تشغيل أمر، شغّل خادم MCP بنفسك أولًا:

uvx --from git+https://github.com/LaurieWired/GhidraMCP ghidra-mcp --transport streamable-http --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/

ثم أضف http://127.0.0.1:8081/mcp كخادم بعيد في عميلك.

مثال 1: VS Code

شغّل MCP: Add Server من لوحة الأوامر، أو أضف ما يلي إلى .vscode/mcp.json في مساحة العمل الخاصة بك:

{
  "servers": {
    "ghidra": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/LaurieWired/GhidraMCP",
        "ghidra-mcp",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

مثال 2: Claude Code

شغّل الأمر التالي:

claude mcp add ghidra -- uvx --from git+https://github.com/LaurieWired/GhidraMCP ghidra-mcp --ghidra-server http://127.0.0.1:8080/

بدون واجهة رسومية (بدون Ghidra GUI)

يمكن لـ ghidra-mcp أيضًا استيراد ملف ثنائي وتحليله بنفسه باستخدام PyGhidra، دون تشغيل واجهة Ghidra الرسومية. يتطلب هذا Python 3.10–3.13، وإضافة GhidraMCP مثبّتة في Ghidra (أو --extension-jar /path/to/GhidraMCP.jar)، وضبط GHIDRA_INSTALL_DIR على دليل Ghidra 12.1.4 الخاص بك:

uvx --python 3.13 --from "ghidra-mcp[headless] @ git+https://github.com/LaurieWired/GhidraMCP" ghidra-mcp --headless --binary /path/to/target

استخدم نفس الأمر والوسائط في أي من إعدادات العملاء أعلاه. أضف --project DIR للاحتفاظ بمشروع Ghidra (وحفظ التغييرات) بين التشغيلات. على macOS، ابنِ مفكّك التجميع الخاص بـ Ghidra مرة واحدة باستخدام support/gradle/gradlew buildNatives من دليل Ghidra.

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

اضبط GHIDRA_INSTALL_DIR على دليل Ghidra 12.1.4 الخاص بك
ابنِ الإضافة باستخدام Gradle (Java 21) عبر تشغيل:

cd extension && $GHIDRA_INSTALL_DIR/support/gradle/gradlew buildExtension

يتضمن ملف zip الناتج في extension/dist/ إضافة Ghidra المبنية ومواردها. هذه الملفات مطلوبة لكي يتعرّف Ghidra على الإضافة الجديدة.

lib/GhidraMCP.jar
extension.properties
Module.manifest

يمكن تشغيل خادم MCP بلغة Python من نسخة محلية عبر uv run ghidra-mcp، واختباره عبر uv run pytest.

GhidraMCP

الأكثر شعبية