تكامل LLDB MCP

يوفر هذا المشروع تكاملًا لبروتوكول السياق النموذجي (MCP) مع LLDB، مما يسمح للمساعدين الذكاء الاصطناعي مثل Claude بالتفاعل مع جلسات التصحيح الخاصة بك من خلال واجهة موحدة.

نظرة عامة

يتكون التكامل من مكونين رئيسيين:

1. server.py - خادم MCP يتواصل مع Claude (أو عملاء MCP آخرين)
2. lldb_plugin.py - إضافة تعمل داخل LLDB وتكشف عن وظائف المصحح عبر JSON-RPC

تتيح هذه البنية لـ Claude مساعدتك في تصحيح الأكواد من خلال التفاعل المباشر مع LLDB عبر اللغة الطبيعية. يعمل خادم MCP كجسر، حيث يترجم طلبات Claude إلى أوامر LLDB ويعيد النتائج بتنسيق منظم.

التثبيت

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

• Python 3.10 أو أحدث
• LLDB مع روابط Python
• حزمة Python fastmcp (لتكامل Claude Desktop)

الإعداد

1. استنساخ هذا المستودع:

   root@kitploit:~

   git clone https://github.com/ant4g0nist/lldb-mcp.git
   cd lldb-mcp
   

2. تثبيت التبعيات المطلوبة:

   root@kitploit:~

   pip install "fastmcp>=1.2.0" httpx
   

   أو

   root@kitploit:~

   uv install "fastmcp>=1.2.0" httpx
   

الاستخدام

الطريقة 1: الاستخدام مع Claude Desktop

1. تأكد من تثبيت Claude for Desktop وتحديثه إلى أحدث إصدار.

2. قم بتكوين Claude for Desktop لاستخدام خادم LLDB MCP عن طريق تحرير:

   • المسار: ~/Library/Application Support/Claude/claude_desktop_config.json

3. قم بتحديث المسارات وإضافة تكوين LLDB MCP:

   root@kitploit:~

   {
     "mcpServers": {
       "lldb": {
         "command": "/path/to/your/.local/bin/uv",
         "args": [
           "--directory",
           "/path/to/your/lldb-mcp/llmcp",
           "run",
           "lldb_mcp.py"
         ]
       }
     }
   }
   

4. أعد تشغيل Claude for Desktop.

5. ابدأ جلسة تصحيح في LLDB وقم بتمكين خادم MCP باستخدام:

   root@kitploit:~

   (lldb) command script import lisa.py
   

6. يجب أن ترى الآن أدوات LLDB متاحة في Claude for Desktop. ابحث عن أيقونة المطرقة.

الطريقة 2: التكامل المباشر مع LLDB

إذا كنت تفضل استخدام الإضافة مباشرة من LLDB بدون Claude for Desktop:

1. أضف ما يلي إلى ملف ~/.lldbinit الخاص بك لتحميل الإضافة تلقائيًا:

   root@kitploit:~

   command script import /path/to/lldb_plugin.py
   

2. في جلسة LLDB الخاصة بك، ابدأ خادم MCP:

   root@kitploit:~

   (lldb) mcp start
   

3. سيكون الخادم متاحًا على http://localhost:13338 لأي عميل MCP للاتصال به.

أدوات LLDB المتاحة

يكشف خادم MCP عن الطرق التالية للمساعدين الذكاء الاصطناعي:

• create_target - إنشاء هدف تصحيح من مسار ملف تنفيذي
• launch_process - تشغيل عملية مع وسائط اختيارية، ومتغيرات بيئة، ودليل عمل
• attach_to_process - الالتصاق بعملية قيد التشغيل بواسطة PID
• detach_from_process - الانفصال عن العملية الحالية
• continue_process - متابعة تنفيذ العملية
• step_over - تجاوز السطر أو التعليمات الحالية
• step_into - الدخول إلى استدعاء دالة
• step_out - الخروج من الدالة الحالية
• set_breakpoint - تعيين نقطة توقف في موقع محدد
• delete_breakpoint - حذف نقطة توقف بواسطة المعرف
• list_breakpoints - سرد جميع نقاط التوقف
• get_backtrace - الحصول على التتبع الخلفي للخيط الحالي أو خيط محدد
• get_variables - الحصول على المتغيرات في الإطار الحالي
• get_disassembly - الحصول على التفكيك حول عنوان محدد أو عداد البرنامج الحالي
• read_memory - قراءة الذاكرة من عنوان محدد
• get_metadata - الحصول على بيانات وصفية حول جلسة التصحيح الحالية
• run_lldb_command - تنفيذ أمر LLDB عشوائي
• evaluate_expression - تقييم تعبير في السياق الحالي

أمثلة على التفاعلات مع Claude

بمجرد الإعداد، يمكنك التفاعل مع LLDB عبر Claude باستخدام اللغة الطبيعية. بعض الأمثلة:

• "صحيح هذا البرنامج في /path/to/executable"
• "اضبط نقطة توقف عند main"
• "شغّل البرنامج مع الوسائط -v input.txt"
• "أظهر لي المتغيرات في الإطار الحالي"
• "ادخل إلى استدعاء الدالة التالية"
• "ما هو التتبع الخلفي الآن؟"
• "قيم التعبير ptr->data[i]"
• "أظهر لي كود التجميع في التعليمات الحالية"

استكشاف الأخطاء وإصلاحها

• الإضافة لا تحمل: تأكد من أن بيئة Python الخاصة بـ LLDB يمكنها الوصول إلى الوحدات الضرورية
• مشكلات اتصال الخادم: تحقق مما إذا كان المنفذ 13338 قيد الاستخدام بالفعل من قبل تطبيق آخر
• Claude لا يكتشف الأدوات: تحقق من صحة التكوين في claude_desktop_config.json
• أخطاء الأوامر: تسجل الإضافة الأخطاء في وحدة تحكم LLDB، تحقق هناك للحصول على التفاصيل

المساهمة

المساهمات مرحب بها! لا تتردد في تقديم طلبات السحب أو إنشاء مشكلات للأخطاء وطلبات الميزات.

الترخيص

ترخيص Apache

المهام المعلقة

• تحديث أدلة التعليمات
• إضافة المزيد من حالات الاختبار

الإسناد

• voltron
• lldb
• chisel
• gef
• pixd
• hexdump
• idaref
• ida-pro-mcp