### डेमो देखें!

- **त्वरित विश्लेषण करें**
  
https://github.com/user-attachments/assets/b65c3041-fde3-4803-8d99-45ca77dbe30a

- **कमज़ोरियाँ तेज़ी से खोजें**

https://github.com/user-attachments/assets/c184afae-3713-4bc0-a1d0-546c1f4eb57f

- **एकाधिक AI एजेंट्स के लिए समर्थन**

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

- **JADX का उपयोग करके APK की डिबगिंग के दौरान आपका AI सहायक**

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 सर्वर है जो MCP (Model Context Protocol) के माध्यम से एक `JADX-AI-MCP` प्लगइन के साथ इंटरैक्ट करता है (देखें: [jadx-ai-mcp](https://github.com/zinja-coder/jadx-ai-mcp))। यह LLMs को डीकंपाइल किए गए 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()` — AndroidManifest.xml फ़ाइल में उल्लिखित jadx से मुख्य एक्टिविटी प्राप्त करें
- `get_main_application_classes_code()` — AndroidManifest.xml में परिभाषित पैकेज नाम के आधार पर सभी मुख्य एप्लिकेशन क्लासेस का कोड प्राप्त करें
- `get_main_application_classes_names()` — AndroidManifest.xml में परिभाषित पैकेज नाम के आधार पर सभी मुख्य एप्लिकेशन क्लासेस के नाम प्राप्त करें
- `get_android_manifest()` — AndroidManifest.xml की सामग्री प्राप्त करके लौटाएँ
- `get_manifest_component` - पूरी मैनिफेस्ट फ़ाइल के बजाय विशिष्ट मैनिफेस्ट कॉम्पोनेंट प्राप्त करें
- `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()` : किसी फ़ील्ड के सभी संदर्भ खोजें (फ़ील्ड तक पहुँचने वाले मेथड्स लौटाता है, पेजिनेशन समर्थित)
  
---

## 🗒️ नमूना प्रॉम्प्ट्स

🔍 बुनियादी कोड समझ

    "Explain what this class does in one paragraph."

    "Summarize the responsibilities of this method."

    "Is there any obfuscation in this class?"

    "List all Android permissions this class might require."

🛡️ भेद्यता पहचान

    "Are there any insecure API usages in this method?"

    "Check this class for hardcoded secrets or credentials."

    "Does this method sanitize user input before using it?"

    "What security vulnerabilities might be introduced by this code?"

🛠️ रिवर्स इंजीनियरिंग सहायक

    "Deobfuscate and rename the classes and methods to something readable."

    "Can you infer the original purpose of this smali method?"

    "What libraries or SDKs does this class appear to be part of?"

    "Tell me which classes contains code related to 'encryption'?"

📦 स्थैतिक विश्लेषण

    "List all network-related API calls in this class."

    "Identify file I/O operations and their potential risks."

    "Does this method leak device info or PII?"

🤖 AI कोड संशोधन

    "Refactor this method to improve readability."

    "Add comments to this code explaining each step."

    "Rewrite this Java method in Python for analysis."

📄 दस्तावेज़ीकरण और मेटाडेटा

    "Generate Javadoc-style comments for all methods."

    "What package or app component does this class likely belong to?"

    "Can you identify the Android component type (Activity, Service, etc.)?"

🐞 डीबगर सहायक```
   "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?"

<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

## a. Install uv (if you dont have it yet)

## 🤖 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

बदलें:

- `path/to/uv` को अपने `uv` एक्जीक्यूटेबल के वास्तविक पथ से बदलें
- `path/to/jadx-mcp-server` को उस पूर्ण पथ से बदलें जहाँ आपने इस रिपॉजिटरी को क्लोन किया है

फिर, अंतर्निहित एकीकरण का उपयोग करके रीयल-टाइम कोड समीक्षा प्रॉम्प्ट के माध्यम से कोड को नेविगेट करें और इंटरैक्ट करें।

**या**

या आप नीचे दिए गए कमांड का उपयोग करके jadx_mcp_server को सीधे एक्जीक्यूटेबल के रूप में स्थापित कर सकते हैं:```
uv tool install git+https://github.com/zinja-coder/jadx-mcp-server

- `path/to/jadx-mcp-server` उस absolute path के साथ जहाँ आपने इस repository को
क्लोन किया है

## 4. LMStudio का उपयोग करना

आप JADX AI MCP Server को LM Studio के साथ भी उपयोग कर सकते हैं, इसकी mcp.json फ़ाइल कॉन्फ़िगर करके। यहाँ वीडियो गाइड है।

https://github.com/user-attachments/assets/b4a6b280-5aa9-4e76-ac72-a0abec73b809

## 5. HTTP Stream Mode में चलाना

आप Jadx को HTTP Stream Mode में `--http` विकल्प के साथ `jadx_mcp_server.py` का उपयोग करके भी चला सकते हैं, जैसा निम्नलिखित में दिखाया गया है:```bash
uv run jadx_mcp_server.py --http

OR

uv run jadx_mcp_server.py --http --port 9999

| फ़्लैग | डिफ़ॉल्ट | नियंत्रण |
|------|---------|----------|
| `--http` | off | stdio के बजाय HTTP ट्रांसपोर्ट का उपयोग करें |
| `--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

**परिदृश्य 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

> [!CAUTION]
> ### ⚠️ सुरक्षा चेतावनी — रिमोट बाइंडिंग
>
> जब `--host 0.0.0.0` (या कोई भी गैर-लोकलहोस्ट पता) उपयोग किया जाता है, तो MCP सर्वर **सभी नेटवर्क इंटरफेस** पर **बिना किसी प्रमाणीकरण के सादे HTTP** के माध्यम से बाइंड होता है। इसका अर्थ है:
>
> - **नेटवर्क पर कोई भी** कनेक्ट होकर सभी MCP टूल्स को इनवोक कर सकता है
> - **कोई TLS एन्क्रिप्शन नहीं है** — ट्रैफ़िक इंटरसेप्ट किया जा सकता है
> - एक हमलावर सर्वर का उपयोग **डिकंपाइल्ड कोड पढ़ने**, **क्लास/मेथड्स का नाम बदलने** और **डीबग जानकारी एक्सेस करने** के लिए कर सकता है
>
> **शमन उपाय:**
> - केवल **विश्वसनीय, आइसोलेटेड नेटवर्क** (जैसे, Docker ब्रिज, लोकल VM) पर `0.0.0.0` से बाइंड करें
> - MCP पोर्ट तक पहुँच प्रतिबंधित करने के लिए **फ़ायरवॉल** का उपयोग करें
> - इसके बजाय एक **SSH टनल** पर विचार करें: `ssh -L 8651:127.0.0.1:8651 remote-host`

### Stdio मोड संगतता

> [!NOTE]
> **stdio** मोड में चलाते समय (डिफ़ॉल्ट, `--http` के बिना), सभी मानव-पठनीय आउटपुट (बैनर, हेल्थ चेक) **stderr** पर लिखा जाता है ताकि **stdout** MCP JSON-RPC स्ट्रीम के लिए आरक्षित रहे। यह Codex, Claude Desktop, और अन्य stdio-आधारित MCP क्लाइंट्स के साथ संगतता सुनिश्चित करता है।

## 6. JADX AI MCP प्लगइन के लिए कस्टम पोर्ट और होस्ट कॉन्फ़िगरेशन

<img width="800" height="335" alt="छवि" 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

### CLI Reference — फ्लैग्स को समझना

यहाँ **दो अलग-अलग कनेक्शन** होते हैं और प्रत्येक का अपना होस्ट/पोर्ट होता है:```
┌─────────────┐    --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         │                  │
└─────────────┘                        └──────────────────┘                               └──────────────────┘

**परिदृश्य 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

**परिदृश्य 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

## इसे आज़माएं

1. jadx-gui चलाएं और कोई भी .apk फ़ाइल लोड करें

![img_1.png](https://assets.kitploit.com/production/public/readmes/6657/57512ca023da5fdca0cc3fac791a68e1c76c9ff4e97d9391ca6fdcf8b6e34bff.png)

2. claude शुरू करें - आपको हथौड़ा चिह्न दिखना चाहिए

![img2.png](https://assets.kitploit.com/production/public/readmes/6657/18d5936ea3d66f3667e827f2b757926f56230f5b0a150eb0077414cca550009e.png)

3. `hammer` चिह्न पर क्लिक करें और आपको कुछ ऐसा दिखना चाहिए:

![img3.png](https://assets.kitploit.com/production/public/readmes/6657/ce4c8a048d32bb1f5a16fed73153b83ec78c3253a0109fb7aa064f064b34fc34.png)

4. निम्नलिखित प्रॉम्प्ट चलाएं:```text
fetch currently selected class and perform quick sast on it