zinja-coder/jadx-ai-mcpمكوّن إضافي لـ JADX لدمج خادم MCP
⚡ خادم MCP آلي بالكامل وإضافة JADX مبنيّة للتواصل مع نموذج لغوي كبير عبر MCP لتحليل ملفات Android APK باستخدام نماذج مثل Claude — اكتشاف الثغرات، تحليل APK، والهندسة العكسية بكل سهولة.
شكرًا لهؤلاء الأشخاص الرائعين على مساهماتهم ⭐
JADX-AI-MCP هو إضافة لمفكك الشيفرة JADX decompiler يتكامل مباشرة مع Model Context Protocol (MCP) لتوفير دعم مباشر للهندسة العكسية باستخدام نماذج لغوية كبيرة مثل Claude.
فكّر في الأمر: «فك التجميع → مراجعة الكود المدركة للسياق → توصيات الذكاء الاصطناعي» — كل ذلك في الوقت الفعلي.
sequenceDiagram LLM CLIENT->>JADX MCP SERVER: INVOKE MCP TOOL JADX MCP SERVER->>JADX AI MCP PLUGIN: INVOKE HTTP REQUEST JADX AI MCP PLUGIN->>REQUEST HANDLERS: INVOKE HTTP REQUEST HANDLER REQUEST HANDLERS->>JADX GUI: PERFORM ACTION/GATHER DATA JADX GUI->>REQUEST HANDLERS: ACTION PERFORMED/DATA GATHERED REQUEST HANDLERS->>JADX AI MCP PLUGIN: CRAFT HTTP RESPONSE JADX AI MCP PLUGIN->>JADX MCP SERVER:HTTP RESPONSE JADX MCP SERVER->>LLM CLIENT: MCP TOOL RESULT
### شاهد العروض التوضيحية!
- **إجراء تحليل سريع**
https://github.com/user-attachments/assets/b65c3041-fde3-4803-8d99-45ca77dbe30a
- **العثور على الثغرات الأمنية بسرعة**
https://github.com/user-attachments/assets/c184afae-3713-4bc0-a1d0-546c1f4eb57f
- **دعم عدة وكلاء ذكاء اصطناعي (AI Agents)**
https://github.com/user-attachments/assets/6342ea0f-fa8f-44e6-9b3a-4ceb8919a5b0
- **التشغيل مع عميل LLM المفضل لديك**
https://github.com/user-attachments/assets/b4a6b280-5aa9-4e76-ac72-a0abec73b809
- **تحليل موارد APK**
https://github.com/user-attachments/assets/f42d8072-0e3e-4f03-93ea-121af4e66eb1
- **مساعدك الذكي أثناء تصحيح أخطاء APK باستخدام JADX**
https://github.com/user-attachments/assets/2b0bd9b1-95c1-4f32-9b0c-38b864dd6aec
إنه مزيج من أداتين:
1. JADX-AI-MCP
2. [JADX MCP SERVER](https://github.com/zinja-coder/jadx-mcp-server)
## 🤖 ما هو JADX-MCP-SERVER؟
**JADX MCP Server** هو خادم Python مستقل يتفاعل مع إضافة `JADX-AI-MCP` (انظر: [jadx-ai-mcp](https://github.com/zinja-coder/jadx-ai-mcp)) عبر MCP (بروتوكول سياق النموذج). يتيح لوكلاء LLM التواصل مع سياق تطبيق Android المُفكَّك مباشرةً.
---
## مشاريع أخرى في Zin MCP Suite
- **[APKTool-MCP-Server](https://github.com/zinja-coder/apktool-mcp-server)**
- **[JADX-MCP-Server](https://github.com/zinja-coder/jadx-mcp-server)**
- **[ZIN-MCP-Client](https://github.com/zinja-coder/zin-mcp-client)**
## أدوات MCP الحالية
أدوات MCP التالية متاحة:
- `fetch_current_class()` — الحصول على اسم الصنف والمصدر الكامل للصنف المحدد
- `get_selected_text()` — الحصول على النص المحدد حالياً
- `get_all_classes()` — سرد جميع الأصناف في المشروع
- `get_class_source()` — الحصول على المصدر الكامل لصنف معين
- `get_method_by_name()` — جلب مصدر دالة معينة
- `search_method_by_name()` — البحث عن دالة عبر الأصناف
- `search_classes_by_keyword()` — البحث عن أصناف يحتوي كودها المصدري على كلمة مفتاحية محددة (يدعم الترقيم الصفحي)
- `get_methods_of_class()` — سرد الدوال في صنف
- `get_fields_of_class()` — سرد الحقول في صنف
- `get_smali_of_class()` — جلب كود smali للصنف
- `get_main_activity_class()` — جلب النشاط الرئيسي من jadx المذكور في ملف AndroidManifest.xml
- `get_main_application_classes_code()` — جلب كود جميع أصناف التطبيق الرئيسية بناءً على اسم الحزمة المعرّف في ملف AndroidManifest.xml
- `get_main_application_classes_names()` — جلب أسماء جميع أصناف التطبيق الرئيسية بناءً على اسم الحزمة المعرّف في ملف AndroidManifest.xml
- `get_android_manifest()` — استرجاع وإرجاع محتوى ملف AndroidManifest.xml
- `get_manifest_component` — استرجاع مكوّن محدد من ملف البيان (manifest) بدلاً من ملف البيان كاملاً
- `get_strings()` : جلب ملف strings.xml
- `get_all_resource_file_names()` : استرجاع أسماء جميع ملفات الموارد الموجودة في التطبيق
- `get_resource_file()` : استرجاع محتوى ملف المورد
- `rename_class()` : إعادة تسمية اسم الصنف
- `rename_method()` : إعادة تسمية الدالة
- `rename_field()` : إعادة تسمية الحقل
- `rename_package()` : إعادة تسمية الحزمة بالكامل
- `rename_variable()` : إعادة تسمية المتغير داخل دالة
- `debug_get_stack_frames()` : الحصول على إطارات المكدس من مصحح أخطاء jadx
- `debug_get_threads()` : الحصول على رؤى حول الخيوط من مصحح أخطاء jadx
- `debug_get_variables()` : الحصول على المتغيرات من مصحح أخطاء jadx
- `xrefs_to_class()` : العثور على جميع المراجع إلى صنف (يرجع مراجع على مستوى الدوال والأصناف، يدعم الترقيم الصفحي)
- `xrefs_to_method()` : العثور على جميع المراجع إلى دالة (يشمل الدوال المرتبطة بالتجاوز، يدعم الترقيم الصفحي)
- `xrefs_to_field()` : العثور على جميع المراجع إلى حقل (يرجع الدوال التي تصل إلى الحقل، يدعم الترقيم الصفحي)
---
## 🗒️ نماذج أوامر (Prompts)
🔍 فهم الكود الأساسي
"اشرح ما يفعله هذا الصنف في فقرة واحدة."
"لخّص مسؤوليات هذه الدالة."
"هل يوجد أي تشويش (obfuscation) في هذا الصنف؟"
"اسرد جميع أذونات Android التي قد يتطلبها هذا الصنف."
🛡️ كشف الثغرات الأمنية
"هل هناك أي استخدامات غير آمنة لواجهات API في هذه الدالة؟"
"افحص هذا الصنف بحثاً عن أسرار أو بيانات اعتماد مكتوبة بشكل ثابت (hardcoded)."
"هل تعقّم هذه الدالة مدخلات المستخدم قبل استخدامها؟"
"ما الثغرات الأمنية التي قد يُدخلها هذا الكود؟"
🛠️ أدوات مساعدة للهندسة العكسية
"أزل التشويش وأعد تسمية الأصناف والدوال إلى أسماء مقروءة."
"هل يمكنك استنتاج الغرض الأصلي من هذه الدالة smali؟"
"ما المكتبات أو حزم SDK التي يبدو أن هذا الصنف جزء منها؟"
"أخبرني أي الأصناف تحتوي على كود متعلق بـ 'التشفير'؟"
📦 التحليل الثابت
"اسرد جميع استدعاءات API المتعلقة بالشبكة في هذا الصنف."
"حدد عمليات إدخال/إخراج الملفات ومخاطرها المحتملة."
"هل تسرّب هذه الدالة معلومات الجهاز أو المعلومات الشخصية القابلة للتعريف (PII)؟"
🤖 تعديل الكود بالذكاء الاصطناعي
"أعد هيكلة هذه الدالة لتحسين قابلية القراءة."
"أضف تعليقات إلى هذا الكود تشرح كل خطوة."
"أعد كتابة هذه الدالة Java بلغة Python للتحليل."
📄 التوثيق والبيانات الوصفية
"أنشئ تعليقات بأسلوب Javadoc لجميع الدوال."
"ما الحزمة أو مكوّن التطبيق الذي ينتمي إليه هذا الصنف على الأرجح؟"
"هل يمكنك تحديد نوع مكوّن Android (Activity أو Service أو غير ذلك)؟"
🐞 مساعد مصحح الأخطاء```
"Fetch stack frames, varirables and threads from debugger and provide summary"
"Based the stack frames from debugger, explain the execution flow of the application"
"Based on the state of variables, is there security threat?"
[!NOTE]
قم بتنزيل كلا الملفين
jadx-ai-mcp-<version>.jarوjadx-mcp-server-<version>.zip.```bash
https://github.com/zinja-coder/jadx-ai-mcp/releases
unzip jadx-ai-mcp-.zip
├jadx-mcp-server/ ├── jadx_mcp.py ├── requirements.txt ├── README.md ├── LICENSE
├jadx-ai-mcp-.jar
jadx plugins --install "github:zinja-coder:jadx-ai-mcp"
<div align="center">
<img alt="banner" height="480px" widht="620px" src="https://assets.kitploit.com/production/public/readmes/6657/1c2660639daf7352d2bdeafeb7b5e0846e3c0bed45846ee52256b7bf3d316386.png">
</div>
<div align="center">
<img alt="banner" height="480px" widht="620px" src="https://assets.kitploit.com/production/public/readmes/6657/ccc2cc3566566517abad1097711afad3c668a999dc105d82686c4ffb791eba3b.png">
</div>
<div align="center">
<img alt="banner" height="480px" widht="620px" src="https://assets.kitploit.com/production/public/readmes/6657/0f9770bc38f4234826a661e6d37bc205a801ad38380363fd4394a903bd35ff94.png">
</div>```bash
## 3. GUI method, download the .jar file and follow below steps shown in images
```bash
cd jadx-mcp-server
## a. Install uv (if you dont have it yet)
curl -LsSf https://astral.sh/uv/install.sh | sh ## b. OPTIONAL, if for any reasons, you get dependecy errors in jadx-mcp-server, Set up the environment uv venv source .venv/bin/activate # or .venv\Scripts\activate on Windows ## c. OPTIONAL Install dependencies uv pip install httpx fastmcp
## 🤖 2. استخدام Claude Desktop
تأكد من أن Claude Desktop قيد التشغيل مع تمكين MCP.
على سبيل المثال، استخدمت ما يلي لنظام Kali Linux: https://github.com/aaddrick/claude-desktop-debian
قم بتكوين وإضافة خادم MCP إلى ملف LLM:```bash
nano ~/.config/Claude/claude_desktop_config.json
لـ:
%APPDATA%\Claude\claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.jsonوالمحتوى التالي فيه:```json { "mcpServers": { "jadx-mcp-server": { "command": "///uv", "args": [ "--directory", "</PATH/TO/>jadx-mcp-server/", "run", "jadx_mcp_server.py" ] } } }
استبدل:
- `path/to/uv` بالمسار الفعلي لملف `uv` التنفيذي
- `path/to/jadx-mcp-server` بالمسار المطلق إلى المكان الذي استنسخت فيه هذا
المستودع
ثم تنقّل في الكود وتفاعل عبر مطالبات مراجعة الكود في الوقت الفعلي باستخدام التكامل المدمج.
**أو**
أو يمكنك تثبيت jadx_mcp_server مباشرة كملف تنفيذي باستخدام الأمر أدناه:```
uv tool install git+https://github.com/zinja-coder/jadx-mcp-server
وبعدها يمكنك فقط توفير jadx_mcp_server في قسم command من إعدادات mcp.
إذا كنت تريد تكوين أداة MCP في Cherry Studio، يمكنك الرجوع إلى الإعدادات التالية.
- `path/to/jadx-mcp-server` مع المسار المطلق إلى حيث استنسخت هذا
المستودع
## 4. استخدام LMStudio
يمكنك أيضًا استخدام JADX AI MCP Server مع LM Studio عن طريق تكوين ملف mcp.json الخاص به. إليك دليل الفيديو.
https://github.com/user-attachments/assets/b4a6b280-5aa9-4e76-ac72-a0abec73b809
## 5. التشغيل في وضع HTTP Stream
يمكنك أيضًا استخدام Jadx في وضع HTTP Stream باستخدام خيار `--http` مع `jadx_mcp_server.py` كما هو موضح في التالي:```bash
uv run jadx_mcp_server.py --http
OR
uv run jadx_mcp_server.py --http --port 9999
يوجد اتصالان منفصلان ولكلٍّ منهما مضيف/منفذ خاص به:``` ┌─────────────┐ --host / --port ┌──────────────────┐ --jadx-host / --jadx-port ┌──────────────────┐ │ LLM Client │ ◄──────────────────► │ jadx-mcp-server │ ──────────────────────────► │ JADX-GUI Plugin │ │ (Claude, │ Where the MCP server │ │ Where the MCP server looks │ (jadx-ai-mcp) │ │ Codex..) │ LISTENS for clients │ │ for the JADX plugin │ │ └─────────────┘ └──────────────────┘ └──────────────────┘
| العلم | الافتراضي | التحكم |
|------|---------|----------|
| `--http` | off | استخدم HTTP كوسيلة نقل بدلاً من stdio |
| `--host` | `127.0.0.1` | **أين يستمع خادم MCP** (عنوان الربط لعملاء LLM) |
| `--port` | `8651` | **على أي منفذ يستمع خادم MCP** |
| `--jadx-host` | `127.0.0.1` | **أين تجد إضافة JADX** (جهاز JADX-GUI الهدف) |
| `--jadx-port` | `8650` | **على أي منفذ تعمل إضافة JADX** |
### أمثلة الاستخدام
**السيناريو 1 — كل شيء على نفس الجهاز (الأكثر شيوعًا):**```bash
# Default: MCP server on localhost:8651, connects to JADX plugin on localhost:8650
uv run jadx_mcp_server.py --http
السيناريو 2 — حاوية Docker أو WSL (خادم MCP يمكن الوصول إليه من شبكة المضيف):```bash
uv run jadx_mcp_server.py --http --host 0.0.0.0
**السيناريو 3 — JADX-GUI يعمل على جهاز مختلف (مثل VM عن بُعد):**```bash
# MCP server runs locally, but connects to JADX plugin on a remote machine
uv run jadx_mcp_server.py --http --jadx-host 192.168.1.100
السيناريو 4 — الإعداد عن بُعد بالكامل (كل شيء على أجهزة مختلفة):```bash
uv run jadx_mcp_server.py --http --host 0.0.0.0 --port 9999 --jadx-host 192.168.1.100 --jadx-port 8652
> [!CAUTION]
> ### ⚠️ تحذير أمني — الربط عن بُعد
>
> عند استخدام `--host 0.0.0.0` (أو أي عنوان غير localhost)، يرتبط خادم MCP بـ **جميع واجهات الشبكة** عبر **HTTP عادي بدون أي مصادقة**. وهذا يعني:
>
> - **يمكن لأي شخص على الشبكة** الاتصال واستدعاء جميع أدوات MCP
> - **لا يوجد تشفير TLS** — يمكن اعتراض حركة المرور
> - يمكن للمهاجم استخدام الخادم لـ **قراءة الشيفرة المُفككة** و**إعادة تسمية الفئات/الدوال** و**الوصول إلى معلومات التصحيح**
>
> **إجراءات التخفيف:**
> - اربط بـ `0.0.0.0` فقط على **شبكات موثوقة ومعزولة** (مثل جسر Docker أو جهاز افتراضي محلي)
> - استخدم **جدار حماية** لتقييد الوصول إلى منفذ MCP
> - فكّر في استخدام **نفق SSH** بدلاً من ذلك: `ssh -L 8651:127.0.0.1:8651 remote-host`
### التوافق مع وضع Stdio
> [!NOTE]
> عند التشغيل في وضع **stdio** (الوضع الافتراضي، بدون `--http`)، تتم كتابة جميع المخرجات القابلة للقراءة البشرية (اللافتة، فحص الصحة) إلى **stderr** لإبقاء **stdout** محجوزًا لتدفق MCP JSON-RPC. وهذا يضمن التوافق مع Codex وClaude Desktop وعملاء MCP الآخرين القائمين على stdio.
## 6. تكوين المنفذ والمضيف المخصص لمكوّن JADX AI MCP
<img width="800" height="335" alt="image" src="https://assets.kitploit.com/production/public/readmes/6657/34e13964afba1fa722733838892491b2ec9ea2d11f2dfd4e8612aa62817dfa41.png" />
1. تكوين المنفذ: قم بتكوين المنفذ الذي سيستمع عليه مكوّن JADX AI MCP.
2. المنفذ الافتراضي: التراجع عن التغييرات والاستماع على المنفذ الافتراضي.
3. إعادة تشغيل الخادم: فرض إعادة تشغيل خادم مكوّن JADX AI MCP.
4. حالة الخادم: تحقق من حالة خادم مكوّن JADX AI MCP.
للاتصال بمكوّن JADX AI MCP الذي يعمل على منفذ مخصص، سيتم استخدام خيار `--jadx-port` كما هو موضح في التالي:```
uv run jadx_mcp_server.py --jadx-port 8652
إذا كان JADX AI MCP Plugin يعمل على جهاز مختلف (مثل JADX على VM بعيد، وخادم MCP على مضيفك المحلي)، استخدم خيار --jadx-host:```bash
uv run jadx_mcp_server.py --jadx-host 192.168.1.100 --jadx-port 8650
### مرجع سطر الأوامر — فهم الخيارات
هناك **اتصالان منفصلان** ولكل منهما مضيف/منفذ خاص به:```
┌─────────────┐ --host / --port ┌──────────────────┐ --jadx-host / --jadx-port ┌──────────────────┐
│ LLM Client │ ◄──────────────────► │ jadx-mcp-server │ ──────────────────────────► │ JADX-GUI Plugin │
│ (Claude, │ Where the MCP server │ │ Where the MCP server looks │ (jadx-ai-mcp) │
│ Codex..) │ LISTENS for clients │ │ for the JADX plugin │ │
└─────────────┘ └──────────────────┘ └──────────────────┘
السيناريو 1 — كل شيء على نفس الجهاز (الأكثر شيوعًا):```bash
uv run jadx_mcp_server.py --http
**السيناريو 2 — حاوية Docker أو WSL (خادم MCP يمكن الوصول إليه من شبكة المضيف):**```bash
# MCP server listens on ALL interfaces so the host can reach it
# JADX plugin is still on the same machine
uv run jadx_mcp_server.py --http --host 0.0.0.0
السيناريو ٣ — JADX-GUI يعمل على جهاز مختلف (مثل VM عن بُعد):```bash
uv run jadx_mcp_server.py --http --jadx-host 192.168.1.100
**السيناريو 4 — الإعداد عن بُعد الكامل (كل شيء على أجهزة مختلفة):**```bash
# MCP server listens on all interfaces on port 9999
# JADX plugin is on a different machine at 192.168.1.100:8652
uv run jadx_mcp_server.py --http --host 0.0.0.0 --port 9999 --jadx-host 192.168.1.100 --jadx-port 8652
سيكون تكوين MCP لمنفذ jadx المخصص على النحو التالي لـ claude:``` { "mcpServers": { "jadx-mcp-server": { "command": "/path/to/uv", "args": [ "--directory", "/path/to/jadx-mcp-server/", "run", "jadx_mcp_server.py", "--jadx-port", "8652" ] } } }
## جربها
1. شغّل jadx-gui وحمّل أي ملف .apk
2. ابدأ claude - يجب أن ترى رمز المطرقة
3. انقر على رمز `hammer` ويجب أن ترى شيئًا مثل التالي:
4. نفّذ المطالبة التالية:```text
fetch currently selected class and perform quick sast on it
يتيح هذا الملحق تحكمًا كاملًا في واجهة المستخدم الرسومية ونموذج المشروع الداخلي لدعم تكامل أعمق مع LLM، بما في ذلك:
يمكن العثور على الملفات المتعلقة بـ JADX-AI-MCP داخل هذا المستودع.
يمكن العثور على الملفات المتعلقة بـ jadx-mcp-server هنا.
يُرجى فتح issue باستخدام القالب المخصص لذلك.
تم اختباره على عميل Claude Desktop، وسيتم اختبار دعم الذكاء الاصطناعي الآخر قريبًا!
هذا المشروع عبارة عن ملحق لـ JADX، وهو مفكك كود أندرويد مفتوح المصدر رائع تم إنشاؤه وصيانته بواسطة @skylot. جميع منطق فك الترجمة الأساسي يعود إليهم. لقد قمت فقط بتوسيعه لدعم خادم MCP الخاص بي بقدرات الذكاء الاصطناعي.
تم تضمين ملف README.md الأصلي من jadx هنا في هذا المستودع للرجوع إليه والاعتراف بالفضل.
أصبح خادم MCP هذا ممكنًا بفضل قابلية توسيع JADX-GUI ومجتمع الهندسة العكسية الرائع لأندرويد.
وأيضًا شكر كبير لـ @aaddrick لتطوير عميل Claude لسطح مكتب لينكس المبني على Debian.
وأخيرًا، شكرًا لـ @anthropics لتطوير بروتوكول سياق النموذج (Model Context Protocol) وفريق @FastMCP.
وبالإضافة إلى ذلك، شكر كبير لجميع المشاريع مفتوحة المصدر التي تُعد تبعيات لهذا المشروع والتي جعلت هذا ممكنًا.
يستخدم هذا المشروع المكتبات الرائعة التالية.
الملحق - Java
خادم MCP - Python
يرث JADX-AI-MCP وجميع المشاريع ذات الصلة رخصة Apache 2.0 من مستودع JADX الأصلي.
إخلاء مسؤولية
أداتا jadx-ai-mcp وjadx_mcp_server مخصصتان حصريًا للأغراض التعليمية والبحثية وتقييم الأمن الأخلاقي. يتم توفيرهما "كما هي" دون أي ضمانات، صريحة أو ضمنية. يتحمل المستخدمون وحدهم مسؤولية ضمان أن استخدامهم لهذه الأدوات يتوافق مع جميع القوانين واللوائح والمبادئ التوجيهية الأخلاقية المعمول بها.
باستخدامك jadx-ai-mcp أو jadx_mcp_server، فإنك توافق على استخدامها فقط في البيئات المصرح لك باختبارها، مثل التطبيقات التي تملكها أو لديك إذن صريح بتحليلها. يُحظر تمامًا أي إساءة استخدام لهذه الأدوات لأغراض الهندسة العكسية غير المصرح بها، أو انتهاك حقوق الملكية الفكرية، أو الأنشطة الضارة.
لن يتحمل مطورو jadx-ai-mcp وjadx_mcp_server أي مسؤولية عن أي ضرر أو فقدان بيانات أو عواقب قانونية أو عواقب أخرى ناتجة عن استخدام هذه الأدوات أو إساءة استخدامها. يتحمل المستخدمون المسؤولية الكاملة عن أفعالهم وأي تأثير ناتج عن استخدامهم.
استخدمها بمسؤولية. احترم الملكية الفكرية. اتبع ممارسات الاختراق الأخلاقي.
صُنع بـ ❤️ لمجتمعي الهندسة العكسية والذكاء الاصطناعي.
| العلم | الافتراضي | التحكم |
|---|
--http | off | استخدام نقل HTTP بدلاً من stdio |
--host | 127.0.0.1 | أين يستمع خادم MCP (عنوان الربط لعملاء LLM) |
--port | 8651 | أي منفذ يستمع عليه خادم MCP |
--jadx-host | 127.0.0.1 | أين تجد إضافة JADX (جهاز JADX-GUI المستهدف) |
--jadx-port | 8650 | على أي منفذ تعمل إضافة JADX |
