IDA Pro MCP

⚠️ संग्रहीत — आधिकारिक Hex-Rays IDA MCP सर्वर द्वारा प्रतिस्थापित

यह परियोजना अब अनुरक्षित नहीं है। 2026-09-27 को Hex-Rays SA ने आधिकारिक IDA MCP सर्वर और IDA Nexus जारी किया। विकास उसी दिन 1.0.0a4 पर रोक दिया गया।

वर्तमान उपयोग के लिए, उनका संस्करण स्थापित करें: uvx ida-hcli mcp install। इसके लिए idalib के साथ IDA 9.4+ आवश्यक है और यह पूरी तरह हेडलेस काम करता है; GUI प्लगइन वैकल्पिक है।

यह रिपॉज़िटरी अपने टेस्ट सूट, दस्तावेज़ीकरण और आर्किटेक्चरल रिकॉर्ड के लिए रखी गई है। पूर्ण समापन विवरण के लिए ARCHIVE.md देखें: यह परियोजना क्या थी, यह क्यों विफल रही, कौन-से भाग स्कैफ़ोल्डिंग थे, और कौन-से भाग अभी भी मूल्यवान हैं। इस README का शेष भाग ऐसी प्रणाली का वर्णन करता है जिसकी अब उपयोग के लिए सिफ़ारिश नहीं की जाती।

IDA Pro MCP, IDA Pro के लिए एक स्थानीय Model Context Protocol सर्वर है। यह एक MCP क्लाइंट को IDB का निरीक्षण करने, IDA से नियतात्मक विश्लेषण परिणाम माँगने, और, जब स्पष्ट रूप से अनुमति दी जाए, एनोटेशन या अन्य परिवर्तन वापस IDB में लिखने की सुविधा देता है। होस्ट प्रक्रिया IDA के बाहर चलती है और डिफ़ॉल्ट रूप से प्रत्येक सत्र के लिए एक अलग IDA हेडलेस प्रक्रिया शुरू करती है।

यह कार्यान्वयन क्यों

• नियतात्मक एजेंट सतह: 102 सख्त-स्कीमा ida_* ऑपरेशन, जिनकी लाइव खोज tools/list और ida_help के माध्यम से होती है।
• स्थानीय-प्रथम आर्किटेक्चर: होस्ट और IDA रनटाइम एक टोकन-संरक्षित लूपबैक ब्रिज के माध्यम से संवाद करते हैं; विश्लेषण पथ में कोई छिपी हुई LLM सेवा नहीं होती।
• साक्ष्य, केवल चैट नहीं: टिकाऊ निष्कर्ष IDB के बाहर उद्गम, विश्वास, जीवनचक्र स्थिति, विरोधाभास और ऑडिट इतिहास सुरक्षित रखते हैं।
• संरक्षित परिवर्तन: IDB-परिवर्तनकारी ऑपरेशन स्पष्ट नीति और जोखिम-स्वीकृति नियंत्रणों के पीछे रहते हैं।
• व्यापक क्लाइंट समर्थन: इंस्टॉलर 22 से अधिक एजेंट वातावरणों और उनके JSON, JSON5, TOML, और YAML कॉन्फ़िगरेशन स्वरूपों को समझता है।

वर्तमान संस्करण 1.0.0a4 है। यह अल्फा सॉफ़्टवेयर है। सार्वजनिक ida_* ऑपरेशन नाम, स्कीमा, और वर्कस्पेस प्रारूप स्थिर 1.0.0 रिलीज़ से पहले बदल सकते हैं। डिफ़ॉल्ट क्लाइंट सतह में 102 सटीक-स्कीमा ऑपरेशन हैं। पूर्ण अनुबंध के लिए लाइव खोज का उपयोग करें: tools/list प्रत्येक ऑपरेशन को उसके स्कीमा के साथ सूचीबद्ध करता है, और ida_help(topic="...") एक ऑपरेशन के लिए सटीक आर्ग्युमेंट और उदाहरण लौटाता है।

स्थापित करने से पहले

आपको आवश्यकता होगी:

• IDA Pro या IDA Home 9.2 या नया, एक उपयोगी idat/idat64 निष्पादन योग्य फ़ाइल के साथ। रिपॉज़िटरी का लाइव टेस्ट साक्ष्य IDA 9.3 और 9.4 को कवर करता है; 9.2 घोषित संगतता न्यूनतम है।
• होस्ट और इंस्टॉलर के लिए Python 3.11 या नया।
• जिन बाइनरीज़ का आप निरीक्षण करने की योजना बनाते हैं उन पर IDA चलाने की अनुमति, और एक प्रबंधित Python वातावरण, सत्र फ़ाइलों, और IDB प्रतियों के लिए पर्याप्त डिस्क स्थान।
• एक MCP क्लाइंट जो स्थानीय stdio सर्वर का समर्थन करता है, जैसे Claude Code, Codex, OpenCode, Claude Desktop, Cursor, VS Code/Copilot, Windsurf, Cline, Roo Code, Gemini CLI, या Antigravity।

सामान्य विश्लेषण के लिए किसी इंटेलिजेंस प्रदाता की आवश्यकता नहीं होती। स्पष्ट इंटेलिजेंस मोड jev, custom, और disabled हैं; अक्षम मोड नियतात्मक लेक्सिकल खोज उपलब्ध रखता है और कोई स्थानीय, Gemini, या नेटिव-मॉडल फ़ॉलबैक नहीं है।

डिफ़ॉल्ट रनटाइम idat है: प्रति सत्र एक हेडलेस IDA प्रक्रिया। idalib बैकएंड प्रयोगात्मक है, इसके लिए idapro पैकेज सक्रिय के साथ IDA 9.3-या-नया इंस्टॉलेशन आवश्यक है, और पहली स्थापना के लिए इसकी आवश्यकता नहीं है।

स्रोत चेकआउट से स्थापित करें

इंस्टॉलर इंस्टॉल रूट के अंतर्गत एक प्रबंधित वातावरण बनाता है, चेकआउट की एक फ़्रोज़न प्रति उसमें स्थापित करता है, और समर्थित क्लाइंट स्थानों के लिए क्लाइंट कॉन्फ़िगरेशन लिखता है। रिपॉज़िटरी रूट से, चलाएँ:

python3 install.py

किसी ज्ञात IDA इंस्टॉलेशन के लिए, इसे स्पष्ट रूप से पास करें:

python3 install.py --ida-dir /path/to/ida-pro-9.3

गैर-इंटरैक्टिव रन के लिए:

python3 install.py --yes --no-ida-prompt --ida-dir /path/to/ida-pro-9.3

इंस्टॉलर IDADIR, IDA_DIR, PATH पर मौजूद IDA एक्ज़ीक्यूटेबल्स, और सामान्य इंस्टॉलेशन डायरेक्टरीज़ के माध्यम से भी IDA ढूँढ सकता है। जब एक से अधिक इंस्टॉलेशन मौजूद हों तो --ida-version किसी संस्करण का चयन करता है। नियोजित परिवर्तनों को पहले देखने के लिए --dry-run का उपयोग करें।

इंस्टॉलर कभी भी कोई प्रोवाइडर मॉडल या रनटाइम डाउनलोड नहीं करता। यह अपने अंतर्निहित क्लाइंट मैप में प्रत्येक क्लाइंट स्थान के लिए कॉन्फ़िगरेशन फ़ाइलें बना या अपडेट कर सकता है, जिनमें वे क्लाइंट भी शामिल हैं जो आपकी मशीन पर इंस्टॉल नहीं हैं। इंस्टॉल रूट में install-report.json जाँचें और यदि आवश्यक हो तो अप्रयुक्त प्रविष्टियाँ हटा दें। मौजूदा नियमित कॉन्फ़िगरेशन फ़ाइलों को बदलने से पहले उनका बैकअप लिया जाता है; विकृत, सिमलिंक किए गए, या गैर-नियमित फ़ाइलों को अधिलेखित करने के बजाय अस्वीकार कर दिया जाता है।

इंस्टॉलेशन के बाद MCP क्लाइंट को पुनः आरंभ करें ताकि यह अपना कॉन्फ़िगरेशन पुनः लोड कर सके।

एजेंट हार्नेस टूल सतह को लाइव खोजते हैं: tools/list प्रत्येक ऑपरेशन को उसके स्कीमा के साथ प्रगणित करता है, और ida_help(topic="...") सटीक आर्ग्युमेंट और एक उदाहरण लौटाता है। कोई स्थिर स्किल फ़ाइलें इंस्टॉल नहीं की जाती हैं।

डिफ़ॉल्ट इंस्टॉल रूट है:

• Linux और macOS: ~/.local/share/ida-pro-mcp
• Windows: %LOCALAPPDATA%/ida-pro-mcp

किसी अन्य स्थान को चुनने के लिए IDA_PRO_MCP_HOME सेट करें या --install-root पास करें।

रिलीज़ आर्टिफ़ैक्ट से इंस्टॉल करें

अल्फा रिलीज़ GitHub Actions द्वारा बनाई जाती हैं और प्रीरिलीज़ के रूप में मैन्युअल रूप से प्रकाशित की जाती हैं। जब कोई रिलीज़ उपलब्ध हो, तो रिलीज़ पेज से bundle.zip या bundle.tar.gz एसेट और उसकी SHA256SUMS फ़ाइल डाउनलोड करें। चेकसम सत्यापित करें, बंडल एक्सट्रैक्ट करें, और इसकी शीर्ष-स्तरीय डायरेक्टरी से इंस्टॉलर चलाएँ:

python3 install.py --yes --no-ida-prompt --ida-dir /path/to/ida-pro-9.3

रिलीज़ में स्क्रिप्टेड Python इंस्टॉलेशन के लिए एक wheel और सोर्स डिस्ट्रिब्यूशन भी शामिल है। बंडल सबसे सरल मार्ग है क्योंकि इसमें इंस्टॉलर और MCP क्लाइंट को कॉन्फ़िगर करने के लिए आवश्यक सभी प्रोजेक्ट फ़ाइलें शामिल हैं। रिलीज़ alpha गुणवत्ता की हैं; अपग्रेड करने से पहले मूल बाइनरी और IDB रखें और रिलीज़ नोट्स पढ़ें।

MCP क्लाइंट कनेक्ट करें

इंस्टॉलर उन क्लाइंट कॉन्फ़िगरेशन पथों के लिए सर्वर प्रविष्टि लिखता है जिन्हें वह जानता है। यह Gemini CLI, Antigravity, Antigravity IDE, Antigravity CLI, Claude Code, Codex, Copilot CLI, OpenCode, Claude Desktop, Cursor, VS Code, Windsurf, Cline, और Roo Code का समर्थन करता है। OpenCode और Copilot-परिवार के क्लाइंट अलग कॉन्फ़िगरेशन आकारों का उपयोग करते हैं; इंस्टॉलर को वे फ़ाइलें लिखने दें या the OpenCode setup guide का पालन करें।

सामान्य JSON प्रारूप का उपयोग करने वाले क्लाइंट के लिए, प्रविष्टि इसके समतुल्य है:

{
  "mcpServers": {
    "ida-pro-mcp": {
      "command": "/path/to/ida-pro-mcp/.venv/bin/python",
      "args": ["-u", "-m", "ida_pro_mcp.host.server"],
      "env": {
        "IDA_PRO_MCP_HOME": "/path/to/ida-pro-mcp",
        "IDADIR": "/path/to/ida-pro-9.3",
        "IDA_MCP_TOOL_SURFACE": "agent"
      }
    }
  }
}

Windows पर, <install-root>/.venv/Scripts/python.exe पर स्थित प्रबंधित इंटरप्रेटर का उपयोग करें। महत्वपूर्ण विवरण हैं प्रबंधित इंटरप्रेटर, -u -m ida_pro_mcp.host.server, चयनित IDA निर्देशिका, और IDA_MCP_TOOL_SURFACE=agent। क्लाइंट को install.py पर इंगित न करें; वह फ़ाइल इंस्टॉलर है, MCP सर्वर नहीं।

क्लाइंट कॉन्फ़िगरेशन बदलने के बाद, क्लाइंट को पूरी तरह से पुनः आरंभ करें और जाँचें कि ida_help इसके उपलब्ध ऑपरेशन्स में दिखाई देता है। यदि क्लाइंट केवल एक लेगेसी व्यापक tool(action=...) इंटरफ़ेस दिखाता है, तो जाँचें कि एनवायरनमेंट IDA_MCP_TOOL_SURFACE=legacy के बजाय डिफ़ॉल्ट agent सरफ़ेस का चयन करता है।

एक पहला उपयोगी सत्र