العودة إلى التحديثات
New releaseJul 25, 2026

ghidra-mcp v6.0.0

خادم MCP يربط بين الهندسة العكسية لـ Ghidra وأدوات الذكاء الاصطناعي: 256 أداة لفك التجميع، ومحاكاة P-code، والتصحيح المباشر، وتحليل تدفق البيانات، والعمليات الدفعية، وفرض الاتفاقيات عبر الوضع بدون واجهة رسومية ووضع واجهة المستخدم الرسومية.

مشاركة

خادم Ghidra MCP

MCP Toplist

Tests Release License GitHub Sponsors

Python Java Ghidra MCP

Stars Last commit Discussions Issues OpenSSF Scorecard

إذا وجدت هذا مفيدًا، فيرجى ⭐ وضع نجمة على المستودع — فهذا يساعد الآخرين على اكتشافه!

إذا كان Ghidra MCP يوفر عليك الوقت، ففكّر في رعاية المشروع. الدعم لمرة واحدة والدعم المتكرر كلاهما يساعدان في تمويل تحديثات التوافق، وتقوية بيئة الإنتاج، والتوثيق، والأدوات الجديدة.

خادم Model Context Protocol (MCP) جاهز للإنتاج يربط قدرات الهندسة العكسية القوية في Ghidra بأدوات الذكاء الاصطناعي الحديثة وأطر الأتمتة. 219 أداة MCP، وسير عمل ذكاء اصطناعي مُختبَرة ميدانيًا، وأكثر تكامل Ghidra-MCP شمولًا متاح — بما في ذلك الآن محاكاة P-code، وتكامل المُنقِّح الحيّ، وتحليل تدفق البيانات عبر رسم PCode البياني.

البدء السريع: تثبيت إصدار (بدون استنساخ، بدون بناء)

كل إصدار يتضمن القطعتين اللتين تحتاجهما: إضافة Ghidra (GhidraMCP-<version>.zip) وجسر MCP (ghidra_mcp_bridge-<version>-py3-none-any.whl).

  1. ثبّت المتطلبات الأساسية: Ghidra 12.2، وJava 25، وuv. لا تُحمَّل الإضافة إلا في إصدار Ghidra الدقيق الذي بُنيت من أجله.

  2. ثبّت الإضافة: في نافذة مشروع Ghidra، اختر File > Install Extensions، وانقر +، واختر ملف GhidraMCP-<version>.zip الذي حمّلته، ثم أعد تشغيل Ghidra.

  3. فعّل الإضافة البرمجية: في نافذة المشروع، اختر File > Configure > Utility > Configure، وحدّد GhidraMCPPlugin. تحقّق من أنه يستجيب:

    curl http://127.0.0.1:8089/check_connection
    # {"status": "ok", "server_kind": "gui", "version": "7.0.0"}
    
  4. ثبّت الجسر (انسخ رابط ملف wheel من صفحة الإصدار نفسها):

    uv tool install https://github.com/bethington/ghidra-mcp/releases/download/v7.0.0/ghidra_mcp_bridge-7.0.0-py3-none-any.whl
    
  5. وجّه عميل MCP الخاص بك إليه، باستخدام المسار المطلق (which bridge-mcp-ghidra، أو where.exe bridge-mcp-ghidra على Windows):

    {
      "mcpServers": {
        "ghidra-mcp": { "command": "/home/<you>/.local/bin/bridge-mcp-ghidra" }
      }
    }
    

    على Windows: "command": "C:\\Users\\<you>\\.local\\bin\\bridge-mcp-ghidra.exe". لا يرى العميل الذي يُشغَّل من واجهة رسومية أو من خدمة مسار PATH الخاص بالصدفة لديك، لذلك يفشل الأمر المجرد bridge-mcp-ghidra مع الخطأ spawn ENOENT.

افتح برنامجًا في Ghidra واطلب من أداة الذكاء الاصطناعي لديك سرد دواله. لقطات شاشة للخطوتين 2-3: docs/INSTALL_GUI.md. البناء من المصدر، وDocker، وناقلات HTTP، وكل خيارات الجسر موضحة أدناه.

أي إصدار ينبغي أن أشغّل؟ الإصدارات الموسومة (7.0.0، 7.1.0، ...) هي إصدارات مستقرة. المرشحات للإصدار وفرع main في مرحلة بيتا: مكتملة الميزات ومُختبرة حيًّا، لكن الأشكال قد تتغير قبل الإصدار النهائي. فرع dev تجريبي: تُدمج الأدوات وتُعاد تسميتها وتُعاد هيكلتها هناك بحرية، لذا لا تبنِ شيئًا على واجهة برمجة التطبيقات الخاصة به.

لماذا Ghidra MCP؟

معظم تطبيقات Ghidra MCP تمنحك حفنة من الأدوات للقراءة فقط وتكتفي بذلك. هذا المشروع مختلف — فقد بناه مهندس هندسة عكسية يستخدمه يوميًا على ملفات ثنائية حقيقية، لا كعرض تجريبي.

  • 219 أداة MCP — أكثر بثلاثة أضعاف من أي تطبيق منافس. ليست عمليات قراءة فقط — بل وصول كتابة كامل لإعادة التسمية والكتابة النوعية والتعليق وإنشاء البنى وتنفيذ النصوص البرمجية ومحاكاة P-code والتنقيح الحي.
  • سير عمل ذكاء اصطناعي مُختبَر ميدانيًا — سير عمل توثيق مُثبت (V5) صُقل عبر مئات الدوال. يتضمن مطالبات خطوة بخطوة، ومرجع الترميز المجري، وأدلة المعالجة الدفعية، واكتشاف الشيفرة اليتيمة.
  • موثوقية بمستوى الإنتاج — معاملات ذرية، وعمليات دفعية (تقليل استدعاءات API بنسبة 93%)، ومهلات قابلة للضبط، ومعالجة أخطاء سلسة. لا إخفاقات صامتة.
  • نقل التوثيق بين الملفات الثنائية — مطابقة بصمة دالة SHA-256 تنشر التوثيق عبر إصدارات الملف الثنائي تلقائيًا. وثّق مرة واحدة، وطبّق في كل مكان.
  • تكامل كامل مع Ghidra Server — اتصل بخوادم Ghidra المشتركة، وأدر المستودعات، والتحكم في الإصدارات، وسير عمل السحب/الإيداع، والتعاون متعدد المستخدمين.
  • أوضاع Headless وGUI — شغّله مع واجهة Ghidra الرسومية أو بدونها. جاهز لـ Docker لخطوط أنابيب CI/CD والتحليل الآلي على نطاق واسع.
  • رأي واضح في التصميم — ينقل الإصدار v5.0 اصطلاحات التسمية وسلامة الأنواع ومعايير التوثيق إلى طبقة الأدوات. ينتج وكلاء الذكاء الاصطناعي والمهندسون البشريون مخرجات متسقة دون أدلة أسلوب في كل مطالبة.

فرض الاصطلاحات

لقد مررت بذلك من قبل: بعد ستة أشهر من بدء مشروع تجد ProcessItem وprocess_items وhandleItem وItemProc في قاعدة الشيفرة نفسها — أربع دوال تفعل الشيء نفسه، سمّاها أربع جلسات أو مهندسون مختلفون دون عقد مشترك. إصلاح ذلك يستغرق وقتًا أطول مما ينبغي، وستتكرر المشكلة.

ينقل الإصدار v5.0 الاصطلاحات من "أشياء يجب تذكّرها" إلى طبقة الأدوات، حيث يمكن فرضها فعليًا.

المستوىالسلوكمثال
إصلاح تلقائييُطبَّق بصمتحقل count على uint32 ← يُضاف إليه البادئة dwCount تلقائيًا عند الحفظ
تحذيريمر التغيير مع إرجاع تحذيرprocessData ← "يجب أن يكون الاسم PascalCase مع فعل: ProcessData"
رفضيُحظر التغيير مع توضيحتغيير النوع undefined → undefined ← "رُفض التغيير عديم الأثر، النوع لم يتغير"

لوكلاء الذكاء الاصطناعي، يعني هذا مخرجات متسقة عبر كل جلسة وكل نموذج وكل تشغيل — دون لصق دليل أسلوب في كل مطالبة. الأداة تعرف القواعد؛ على النموذج فقط اتخاذ القرار.

للفرق، يلغي هذا الفئة بأكملها من تعليقات المراجعة التي تقول "هذا ليس اصطلاح التسمية لدينا." يبقى تحكيم الاصطلاحات في الأداة، لا في مراجعة الشيفرة.

الفئات