LLDB MCP एकीकरण

यह परियोजना LLDB के लिए Model-Context Protocol (MCP) एकीकरण प्रदान करती है, जिससे Claude जैसे AI सहायक एक मानकीकृत इंटरफ़ेस के माध्यम से आपके डीबगिंग सत्रों के साथ बातचीत कर सकते हैं।

अवलोकन

एकीकरण में दो मुख्य घटक शामिल हैं:

1. server.py - एक MCP सर्वर जो Claude (या अन्य MCP क्लाइंट) के साथ संचार करता है
2. lldb_plugin.py - एक प्लगइन जो LLDB के अंदर चलता है और JSON-RPC के माध्यम से डीबगर कार्यक्षमता को उजागर करता है

यह आर्किटेक्चर Claude को प्राकृतिक भाषा के माध्यम से LLDB से सीधे बातचीत करके कोड डीबग करने में आपकी मदद करने की अनुमति देता है। MCP सर्वर एक सेतु के रूप में कार्य करता है, Claude के अनुरोधों को LLDB कमांड में अनुवाद करता है और परिणामों को एक संरचित प्रारूप में लौटाता है।

स्थापना

पूर्वापेक्षाएँ

• Python 3.10 या उच्चतर
• Python बाइंडिंग के साथ LLDB
• fastmcp Python पैकेज (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 for 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. अब आपको Claude for Desktop में LLDB उपलब्ध टूल्स दिखाई देंगे। हथौड़ा आइकन देखें।

विधि 2: प्रत्यक्ष LLDB एकीकरण

यदि आप Claude for Desktop के बिना सीधे LLDB से प्लगइन का उपयोग करना पसंद करते हैं:

1. प्लगइन को स्वचालित रूप से लोड करने के लिए अपनी ~/.lldbinit फ़ाइल में निम्नलिखित जोड़ें:

   root@kitploit:~

   command script import /path/to/lldb_plugin.py
   

2. अपने LLDB सत्र में, MCP सर्वर शुरू करें:

   root@kitploit:~

   (lldb) mcp start
   

3. सर्वर किसी भी MCP क्लाइंट को कनेक्ट करने के लिए http://localhost:13338 पर उपलब्ध होगा।

उपलब्ध LLDB टूल्स

MCP सर्वर AI सहायकों के लिए निम्नलिखित विधियाँ उजागर करता है:

• create_target - एक निष्पादन योग्य पथ से डीबग लक्ष्य बनाएं
• launch_process - वैकल्पिक तर्कों, पर्यावरण चर और कार्यशील निर्देशिका के साथ एक प्रक्रिया लॉन्च करें
• attach_to_process - PID द्वारा चल रही प्रक्रिया से जुड़ें
• detach_from_process - वर्तमान प्रक्रिया से अलग हों
• continue_process - प्रक्रिया निष्पादन जारी रखें
• step_over - वर्तमान लाइन या निर्देश पर कदम रखें
• step_into - फ़ंक्शन कॉल में प्रवेश करें
• step_out - वर्तमान फ़ंक्शन से बाहर निकलें
• set_breakpoint - निर्दिष्ट स्थान पर ब्रेकपॉइंट सेट करें
• delete_breakpoint - ID द्वारा ब्रेकपॉइंट हटाएं
• list_breakpoints - सभी ब्रेकपॉइंट सूचीबद्ध करें
• get_backtrace - वर्तमान थ्रेड या निर्दिष्ट थ्रेड के लिए बैकट्रेस प्राप्त करें
• get_variables - वर्तमान फ्रेम में चर प्राप्त करें
• get_disassembly - निर्दिष्ट पते या वर्तमान PC के आसपास डिसअसेंबली प्राप्त करें
• read_memory - किसी विशिष्ट पते से मेमोरी पढ़ें
• get_metadata - वर्तमान डीबगिंग सत्र के बारे में मेटाडेटा प्राप्त करें
• run_lldb_command - एक मनमाना LLDB कमांड निष्पादित करें
• evaluate_expression - वर्तमान संदर्भ में अभिव्यक्ति का मूल्यांकन करें

Claude के साथ उदाहरण इंटरैक्शन

सेटअप होने के बाद, आप प्राकृतिक भाषा का उपयोग करके Claude के माध्यम से LLDB के साथ बातचीत कर सकते हैं। कुछ उदाहरण:

• "इस प्रोग्राम को /path/to/executable पर डीबग करें"
• "main पर एक ब्रेकपॉइंट सेट करें"
• "प्रोग्राम को तर्कों -v input.txt के साथ चलाएं"
• "मुझे वर्तमान फ्रेम में चर दिखाएं"
• "अगले फ़ंक्शन कॉल में कदम रखें"
• "अभी बैकट्रेस क्या है?"
• "अभिव्यक्ति ptr->data[i] का मूल्यांकन करें"
• "मुझे वर्तमान निर्देश पर असेंबली कोड दिखाएं"

समस्या निवारण

• प्लगइन लोड नहीं हो रहा: सुनिश्चित करें कि LLDB का Python वातावरण आवश्यक मॉड्यूल तक पहुँच सकता है
• सर्वर कनेक्शन समस्याएँ: जाँचें कि पोर्ट 13338 पहले से किसी अन्य एप्लिकेशन द्वारा उपयोग में तो नहीं है
• Claude द्वारा टूल्स का पता नहीं लगना: claude_desktop_config.json में सही कॉन्फ़िगरेशन सत्यापित करें
• कमांड त्रुटियाँ: प्लगइन त्रुटियों को LLDB कंसोल में लॉग करता है, विवरण के लिए वहाँ जाँचें

योगदान

योगदान का स्वागत है! कृपया बग और फीचर अनुरोधों के लिए पुल अनुरोध सबमिट करने या मुद्दे बनाने में संकोच न करें।

लाइसेंस

Apache License

TODO

• निर्देश मैनुअल अपडेट करें
• और टेस्टकेस जोड़ें

क्रेडिट

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