
خادم MCP لـ IDA Pro بدون واجهة رسومية لتحليل الثنائيات بمساعدة الذكاء الاصطناعي، مدعوم بـ idalib
أداة CLI بلا واجهة رسومية لـ IDA، ومجموعة أدوات قائمة على المهارات لتحليل الملفات الثنائية على macOS وLinux. تختار ida-cli تلقائيًا الواجهة الخلفية لبيئة التشغيل، وتبدأ خادمًا محليًا تلقائيًا عند الحاجة، وتكشف عن نفس السطح عبر CLI مسطح، ونقل MCP عبر stdio، ونقل MCP عبر Streamable HTTP.
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_numberrun_scriptتستخدم جميع الأدوات 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 مفقودًا، فإن الغلاف يثبّته عبر مثبّت المستودع
قبل تمرير الأمر.
استخدم هذا فقط إذا كنت تريد واجهة سطر الأوامر المستقلة دون المرور عبر المهارة.
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 هذا بملف rc الخاص بالصدفة لديك..app ضمن /Applications أو ~/Applications ويطبع الإصدار المختار والمرشحات الأخرى. 9.10 أحدث من 9.9؛ المكوّنات الصفرية اللاحقة متساوية، مع فضّ التعادل بترتيب المسار القانوني. يحظى IDADIR الصريح بالأولوية. يفشل wheel/runtime المختار غير المتوافق صراحةً. إذا لم يُعثر على أي مرشح، يفشل التثبيت مع تعليمات لتعيين IDADIR.IDADIR الصريح؛ تُقبل مسارات .app وContents و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"}}'
لمعرفة قواعد البيانات التي يحتفظ بها الخادم (daemon) مفتوحةً حاليًا، وأي العملاء يحتفظون بها، شغّل list-idbs (أداة MCP: list_idbs). شغّله قبل إعادة بناء أو استبدال ملف .i64، على سبيل المثال باستخدام idat: قاعدة البيانات التي لا تزال مُدرجة محتفظٌ بها مفتوحةً من قِبل الخادم، ويفشل idat على قاعدة بيانات مفتوحة في مكان آخر. الإجابة هي {"count": N, "idbs": [...]}؛ يحتوي كل إدخال على db_handle، ومسار الإدخال ومسار .i64، ومعرّف غير شفاف للعميل الذي فتحها، ووقت فتحها، وعملية العامل (worker process)، وما إذا كانت قاعدة البيانات النشطة، والعملاء الذين لا يزالون يحتفظون بمراجع إليها. لا تُعاد رموز الإغلاق (close tokens) أبدًا.
./target/debug/ida-cli list-idbs --json
للحصول على العنوان الكامن خلف كل سطر من الشيفرة الزائفة، أضف --line-addresses إلى decompile (في MCP وRPC: line_addresses: true على decompile_function). تصبح الإجابة {"code": ..., "lines": [...]}: حيث code هو النص المعتاد، وكل مدخل في lines هو {"line", "text", "addresses"}. يُعدّ line بدءًا من 1، وtext هو ذلك السطر من code، وaddresses هي عناوين IDA (سلاسل سداسية عشرية، تصاعدية، بلا تكرارات) لعناصر ctree التي رسّخها Hex-Rays على السطر. قد يُقابل السطر عدة عناوين غير متجاورة، والقائمة ليست كل تعليمة في العبارة. لا تحتوي التوقيع والتعريفات المحلية على أي منها؛ وقد تحمل الأسطر { و} وelse والأسطر الفارغة عنوان الكتلة أو if التي تملكها (مدخل الدالة بالنسبة للأقواس الخارجية). لا يُضاف تلميح إعادة التسمية sub_ في هذا الوضع. قد يطبع Hex-Rays دالة كبيرة جدًا بشكل مختلف من استدعاء إلى آخر، لذا استخدم code وlines من الإجابة نفسها فقط. يدعم Nexus هذا الوضع. عبر مقبس CLI تُخزَّن الإجابة الكبيرة في ذاكرة التخزين المؤقت للاستجابات كأي إجابة أخرى (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.
IDADIR (يبدأ دعم وقت التشغيل من IDA 9.4)يحدد المشغّل بيئة Python المخصصة له؛ يمكن لعمليات البناء من المصدر تعيين IDA_NEXUS_PYTHON. لا يزال التحضير غير المتصل لـ sBPF/DSC يستخدم sbx/idat؛ أما الاستعلامات العادية والتعديلات وجلسات قواعد البيانات فتستخدم Nexus. يستخدم التراجع الملف التنفيذي الثابت N0 ونسخة احتياطية مغلقة قبل الترحيل في دليل استرداد منفصل. يتطلب تثبيت بيئة حقيقية أو التبديل بينها تفويضًا صريحًا.