
हेडलेस IDA Pro MCP सर्वर, idalib द्वारा संचालित AI-सहायता प्राप्त बाइनरी विश्लेषण के लिए।
macOS और Linux पर बाइनरी विश्लेषण के लिए हेडलेस IDA CLI और स्किल-फर्स्ट टूलकिट। ida-cli स्वचालित रूप से एक रनटाइम बैकएंड चुनता है, आवश्यकता पड़ने पर स्थानीय सर्वर को स्वचालित रूप से शुरू करता है, और एक फ्लैट CLI, एक stdio MCP ट्रांसपोर्ट, और एक Streamable HTTP MCP ट्रांसपोर्ट के रूप में समान सतह प्रदान करता है।
ida-cli बाइनरी (एक ही निष्पादन योग्य फ़ाइल में क्लाइंट + सेवा)ida-cli स्किल (skill/SKILL.md)अंतर्निहित वर्कर / राउटर सेवा परत CLI द्वारा स्वचालित रूप से शुरू और बंद की जाती है। आपको केवल तभी स्पष्ट रूप से serve / serve-http चलाने की आवश्यकता है जब आप वास्तव में एक दीर्घकालिक, बाहरी रूप से पता योग्य सेवा चाहते हैं।
रनटाइम आवश्यकताएँ: IDA 9.4/9.5 और Python >=3.11। सभी डेटाबेस संचालन समर्पित पिन किए गए Nexus 0.13.4 / Domain 0.5.1 वातावरण का उपयोग करते हैं। अनुपस्थित निर्भरताएँ या बेमेल पैच स्पष्ट रूप से विफल होते हैं। Rust बिल्ड्स को IDA SDK की आवश्यकता नहीं होती है।
समर्थित IDA 9.x रनटाइम पर, ida-cli यह कर सकता है:
.i64 डेटाबेस का पुनः उपयोग करनाread_* और convert_number हेल्पर्स लागू करनाrun_script के माध्यम से IDAPython स्निपेट्स चलानासभी टूल्स स्पष्ट क्षमता त्रुटियों के साथ Nexus का उपयोग करते हैं। जनरेट किए गए टूल सूची के लिए docs/TOOLS.md देखें।
डिफ़ॉल्ट प्रवेश बिंदु ida-cli स्किल है, मैन्युअल CLI इंस्टॉल नहीं।
# list the skill exposed by this repository
npx -y skills add https://github.com/cpkt9762/ida-cli --list
# install the ida-cli skill for Codex
npx -y skills add https://github.com/cpkt9762/ida-cli --skill ida-cli --agent codex --yes --global
इंस्टॉल के बाद, स्किल अपना स्वयं का बूटस्ट्रैप रैपर शिप करता है:
~/.agents/skills/ida-cli/scripts/ida-cli.sh --help
~/.agents/skills/ida-cli/scripts/ida-cli.sh probe-runtime
~/.agents/skills/ida-cli/scripts/ida-cli.sh --path /path/to/binary list-functions --limit 20
यदि ida-cli अनुपस्थित है, तो wrapper कमांड को आगे भेजने से पहले इसे रिपॉज़िटरी इंस्टॉलर के माध्यम से इंस्टॉल करता है।
इसका उपयोग केवल तब करें जब आप skill के माध्यम से जाए बिना स्टैंडअलोन CLI चाहते हैं।
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
उपयोगी वेरिएंट:
# install a specific release
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --tag v0.9.3 --add-path
# build directly from a branch or ref
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --ref master --build-from-source --add-path
नोट्स:
~/.local/bin/ida-cli में रखता है।--add-path उस bin डायरेक्टरी को आपकी shell rc फ़ाइल में जोड़ता है।/Applications या ~/Applications के अंतर्गत नवीनतम संख्यात्मक .app संस्करण चुनता है और चयनित तथा अन्य उम्मीदवारों को प्रिंट करता है। 9.10, 9.9 से नया है; अंत में आने वाले शून्य घटक समान होते हैं, और टाई को canonical path क्रम तोड़ता है। स्पष्ट IDADIR को प्राथमिकता मिलती है। असंगत चयनित wheel/runtime स्पष्ट रूप से विफल होता है। यदि कोई उम्मीदवार नहीं मिलता है, तो इंस्टॉलेशन IDADIR सेट करने के निर्देशों के साथ विफल हो जाता है।IDADIR इसे ओवरराइड करता है; .app, Contents और runtime पथ स्वीकार किए जाते हैं। देखें संस्करण तुलना और runtime जाँच।git clone https://github.com/cpkt9762/ida-cli.git
cd ida-cli
export IDADIR="/Applications/IDA Professional 9.5.app/Contents/MacOS" # or a Linux install
cargo build --bin ida-cli
./target/debug/ida-cli --help
ida-cli क्लाइंट-प्रथम है। कोई भी क्लाइंट सबकमांड एक स्थानीय
Streamable-HTTP सर्वर को स्वतः प्रारंभ करता है जो एक यादृच्छिक पोर्ट से बंधा होता है और खोज के लिए
/tmp/ida-cli.socket लिखता है:
./target/debug/ida-cli --path /path/to/sample.bin list-functions --limit 20
./target/debug/ida-cli --path /path/to/sample.bin decompile --addr 0x140001000
./target/debug/ida-cli --path /path/to/sample.bin raw '{"method":"get_xrefs_to","params":{"address":"0x140001000"}}'
यह देखने के लिए कि डेमॉन वर्तमान में कौन-से डेटाबेस खुले रखे हुए है, और कौन-से क्लाइंट उन्हें होल्ड कर रहे हैं, list-idbs चलाएँ (MCP टूल: list_idbs)। किसी .i64 को फिर से बनाने या बदलने से पहले इसे चलाएँ, उदाहरण के लिए idat के साथ: जो डेटाबेस अभी भी सूचीबद्ध है, वह डेमॉन द्वारा खुला रखा गया है, और idat उस डेटाबेस पर विफल हो जाता है जो कहीं और खुला है। उत्तर {"count": N, "idbs": [...]} होता है; प्रत्येक प्रविष्टि में db_handle, इनपुट पथ और .i64 पथ, इसे खोलने वाले क्लाइंट की एक अपारदर्शी आईडी, इसे कब खोला गया, वर्कर प्रोसेस, क्या यह सक्रिय डेटाबेस है, और वे क्लाइंट जो अभी भी संदर्भ होल्ड करते हैं, शामिल होते हैं। क्लोज़ टोकन कभी नहीं लौटाए जाते।
./target/debug/ida-cli list-idbs --json
प्रत्येक पंक्ति के pseudocode के पीछे का पता प्राप्त करने के लिए, decompile में --line-addresses जोड़ें (MCP और RPC: decompile_function पर line_addresses: true)। उत्तर {"code": ..., "lines": [...]} बन जाता है: code सामान्य टेक्स्ट है और प्रत्येक lines प्रविष्टि {"line", "text", "addresses"} है। line 1 से गिना जाता है, text code की वह पंक्ति है, और addresses उन ctree आइटम्स के IDA पते (hex स्ट्रिंग्स, आरोही क्रम में, बिना दोहराव के) हैं जिन्हें Hex-Rays ने उस पंक्ति पर एंकर किया है। एक पंक्ति कई गैर-सन्निहित पतों से मैप हो सकती है, और यह सूची कथन के प्रत्येक निर्देश की नहीं है। सिग्नेचर और स्थानीय घोषणाओं में कोई पता नहीं होता; {, }, else और खाली पंक्तियाँ उस ब्लॉक या if का पता ले सकती हैं जो उनका स्वामी है (सबसे बाहरी ब्रेसिज़ के लिए फ़ंक्शन प्रवेश बिंदु)। इस मोड में sub_ नाम-परिवर्तन संकेत नहीं जोड़ा जाता। Hex-Rays एक बहुत बड़े फ़ंक्शन को एक कॉल से दूसरे कॉल में भिन्न रूप से प्रिंट कर सकता है, इसलिए केवल एक ही उत्तर से code और lines का उपयोग करें। Nexus इस मोड का समर्थन करता है। CLI सॉकेट पर एक बड़ा उत्तर किसी भी अन्य उत्तर की तरह response cache में संग्रहीत होता है (IDA_MCP_MAX_INLINE_BYTES)।
{"line": 6, "text": " while ( a1 != 1 )", "addresses": ["0x10000033c", "0x100000340"]}
जिन कमांडों का पहला आर्ग्युमेंट एक सर्विस सबकमांड (serve, serve-http, serve-worker, probe-runtime) होता है, वे इसके बजाय सर्विस मोड में प्रवेश करते हैं:
./target/debug/ida-cli serve # stdio MCP transport
./target/debug/ida-cli serve-http --bind 127.0.0.1:8765
./target/debug/ida-cli probe-runtime
probe-runtime Nexus निर्भरताओं, पैचों और प्रोटोकॉल तैयारी की जाँच करता है; बेमेल होने पर नॉनज़ीरो के साथ बाहर निकलता है।
पूरी CLI सतह के लिए देखें skill/references/cli-tool-reference.md।
हमारे समुदाय द्वारा सबसे अधिक उपयोग किए जाने वाले उपकरण खोजें।
अभी तक कोई लोकप्रियता डेटा नहीं है।