android-decompile-mcp 0.0.0-stage → 1.0.0

package/README.fr.md

@@ -0,0 +1,226 @@
+# DexAndroid
+
+[English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [日本語](./README.ja.md) · [한국어](./README.ko.md) · [Español](./README.es.md) · **Français** · [Deutsch](./README.de.md) · [Português](./README.pt-BR.md) · [Русский](./README.ru.md) · [العربية](./README.ar.md) · [हिन्दी](./README.hi.md) · [Bahasa Indonesia](./README.id.md) · [Tiếng Việt](./README.vi.md) · [ไทย](./README.th.md) · [Italiano](./README.it.md) · [Türkçe](./README.tr.md)
+
+> ⚠️ **Uniquement à des fins d’apprentissage et d’enseignement.** Interdit pour toute activité illégale, crack non autorisé, contrefaçon ou contournement de protections. Respectez les lois locales et les conditions de l’application. Vous êtes responsable des abus.
+
+**MCP Server** de dépaquetage Android + analyse smali. Depuis Cursor / Claude : appareils, détection de packers, unpack statique / BlackDex / Frida, dex→smali, recherche d’API.
+
+Repo: [https://github.com/TimeCyber/DexAndroid](https://github.com/TimeCyber/DexAndroid)
+
+---
+
+## Fonctionnalités
+
+| Capacité | Outil MCP | Notes |
+| --- | --- | --- |
+| Devices | `list_devices` | Connected ADB devices |
+| Packages | `list_packages` | Optional keyword filter |
+| Packer detect | `detect_packer` | 360 / Tencent / Bangcle / ijiami / Alibaba, etc. |
+| Pull APK | `pull_apk` | Installed app (+ splits) |
+| Static unpack | `static_unpack` | Extract `classes*.dex` |
+| No-Root unpack | `blackdex_prepare` / `blackdex_pull` | BlackDex memory dump |
+| Root unpack | `frida_prepare` / `frida_unpack` | frida-server + frida-dexdump |
+| Decompile | `dex_to_smali` | baksmali → smali |
+| Analyze | `smali_list_classes` / `smali_read_class` / `smali_search` | List / read / regex |
+
+### Méthodes d’unpack
+
+| Méthode | Root ? | Cas d’usage |
+| --- | --- | --- |
+| Static | No | Unpacked apps or shell/resources only |
+| BlackDex | No | Most protected apps |
+| Frida | **Yes** | Strong packers / fuller dumps |
+
+---
+
+## Prérequis
+
+- **Windows / macOS / Linux** (docs use Windows examples)
+- **Node.js** ≥ 18
+- **ADB** on PATH, or set `ADB_PATH`
+- **Java 8+** (for baksmali via `dex_to_smali`)
+- Optional: [BlackDex](https://github.com/CodingGay/BlackDex/releases); rooted device + `frida-server`; `pip install frida-tools frida-dexdump`
+
+Place baksmali fat jar / frida-server / BlackDex under local `tools/` (large binaries are gitignored).
+
+---
+
+## Installation et build
+
+```bash
+git clone https://github.com/TimeCyber/DexAndroid.git
+cd DexAndroid
+npm install
+npm run build
+```
+
+Démarrer le MCP (stdio):
+
+```bash
+npm start
+# node dist/index.js
+```
+
+Mode développement:
+
+```bash
+npm run dev
+```
+
+---
+
+## Intégration Cursor (MCP)
+
+Ajoutez dans `.cursor/mcp.json` (**adaptez les chemins**) :
+
+```json
+{
+  "mcpServers": {
+    "dex-android-unpack": {
+      "command": "node",
+      "args": ["E:/DexAndroid/dist/index.js"],
+      "env": {
+        "ADB_PATH": "E:/Android/Sdk/platform-tools/adb.exe",
+        "DEX_OUT_DIR": "E:/DexAndroid/unpack-output"
+      }
+    }
+  }
+}
+```
+
+Redémarrez Cursor / rechargez le MCP.
+
+---
+
+## Variables d’environnement
+
+| Variable | Signification | Défaut |
+| --- | --- | --- |
+| `ADB_PATH` | adb executable | `adb` |
+| `DEX_OUT_DIR` | Default output dir | `<cwd>/unpack-output` |
+| `BAKSMALI_JAR` | baksmali jar | auto-discover under `tools/` |
+
+---
+
+## Flux typiques
+
+### 1. Unpack statique (le plus rapide)
+
+1. `list_devices` or prepare local `apkPath`.
+2. `detect_packer`.
+3. `static_unpack` → `classes*.dex`.
+4. `dex_to_smali` → smali folder.
+5. `smali_search` / `smali_read_class`.
+
+**Note:** Protected apps often yield only the shell via static unpack—use BlackDex / Frida for business code.
+
+### 2. Sans Root (BlackDex)
+
+1. `list_devices`.
+2. `blackdex_prepare` with `blackdexApkPath`.
+3. Unpack the target app in BlackDex UI.
+4. `blackdex_pull` with `targetPkg`.
+5. `dex_to_smali` then `smali_*`.
+
+### 3. Avec Root (Frida)
+
+1. Rooted device (e.g. Magisk), `adb` ready.
+2. `frida_prepare` to push/start `tools/frida-server`.
+3. Matching `frida` / `frida-dexdump` locally (prefer 16.x).
+4. `frida_unpack` with `pkg`, prefer `spawn: true`, `deepSearch: true`.
+5. `dex_to_smali` on output, then analyze.
+
+If Frida 17 attach fails, align tools to 16.x; some devices need temporary `setenforce 0`.
+
+### 4. Exemples smali
+
+```text
+smali_list_classes  smaliDir=.../smali  keyword=login
+smali_search        smaliDir=.../smali  pattern=https?://|/api/|publicClient/
+smali_read_class    smaliDir=.../smali  className=com.example.api.ApiService
+```
+
+---
+
+## Structure
+
+```text
+DexAndroid/
+├── src/                 # MCP server (TypeScript)
+│   ├── index.ts
+│   ├── adb.ts
+│   ├── detect.ts
+│   ├── smali.ts
+│   └── unpack/
+├── dist/
+├── examples/            # Damai / Huaxi sample smali.zip + docs
+├── tools/               # baksmali / frida-server / BlackDex (local)
+├── unpack-output/       # local dumps (gitignored)
+├── package.json
+└── README.md
+```
+
+---
+
+## Exemples de décompilation
+
+Voir [`examples/`](./examples/) (smali en zip) :
+
+| Exemple | Chemin | Contenu |
+| --- | --- | --- |
+| Damai | [`examples/damai/`](./examples/damai/) | Frida smali.zip + API docs |
+| Huaxi Maternity | [`examples/huaxi/`](./examples/huaxi/) | Static smali.zip (`info.cd120.two`) |
+
+Après extraction, utilisez `smali_*`.
+
+---
+
+## Aide-mémoire MCP
+
+| Tool | Params |
+| --- | --- |
+| `detect_packer` | `apkPath` or `pkg`, optional `serial` |
+| `pull_apk` | `pkg`, optional `outDir` / `serial` |
+| `static_unpack` | `apkPath` or `pkg`, optional `outDir` |
+| `blackdex_prepare` | `blackdexApkPath`, optional `serial` |
+| `blackdex_pull` | `targetPkg`, optional `outDir` / `serial` |
+| `frida_prepare` | optional `serial` / `serverLocalPath` |
+| `frida_unpack` | `pkg`, optional `spawn` / `deepSearch` / `outDir` |
+| `dex_to_smali` | `dexInput`, optional `outDir` |
+| `smali_list_classes` | `smaliDir`, optional `keyword` |
+| `smali_read_class` | `smaliDir`, `className` |
+| `smali_search` | `smaliDir`, `pattern`, optional `flags` / `maxResults` |
+
+---
+
+## FAQ
+
+**Q: Empty `list_devices`?**  
+Check USB debugging, `adb devices`, pass `serial` if multiple.
+
+**Q: No business classes after static unpack?**  
+Likely packed—use BlackDex or Frida.
+
+**Q: `dex_to_smali` failed?**  
+Install Java; put baksmali jar in `tools/` or set `BAKSMALI_JAR`.
+
+**Q: Frida jailed / version mismatch?**  
+Keep `frida-server` and host `frida` major versions aligned; try 16.x.
+
+**Q: Where is output?**  
+Default `unpack-output/` (or `DEX_OUT_DIR`). **Do not commit dumps.**
+
+---
+
+## Mentions légales
+
+Ce projet est **réservé à l’apprentissage, l’enseignement et la recherche en sécurité autorisée**. Toute utilisation criminelle ou illégale (accès non autorisé, crack, piratage, attaques, atteinte à la PI) est interdite. Les auteurs ne sont pas responsables des abus. L’utilisation vaut acceptation.
+
+> ⚠️ **Uniquement à des fins d’apprentissage et d’enseignement.** Interdit pour toute activité illégale, crack non autorisé, contrefaçon ou contournement de protections. Respectez les lois locales et les conditions de l’application. Vous êtes responsable des abus.
+
+---
+
+## License
+
+MIT — see [`LICENSE`](./LICENSE).

package/README.hi.md

@@ -0,0 +1,226 @@
+# DexAndroid
+
+[English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [日本語](./README.ja.md) · [한국어](./README.ko.md) · [Español](./README.es.md) · [Français](./README.fr.md) · [Deutsch](./README.de.md) · [Português](./README.pt-BR.md) · [Русский](./README.ru.md) · [العربية](./README.ar.md) · **हिन्दी** · [Bahasa Indonesia](./README.id.md) · [Tiếng Việt](./README.vi.md) · [ไทย](./README.th.md) · [Italiano](./README.it.md) · [Türkçe](./README.tr.md)
+
+> ⚠️ **केवल सीखने और शिक्षण के लिए।** किसी भी अवैध गतिविधि, अनधिकृत क्रैकिंग, कॉपीराइट उल्लंघन या दूसरों की सुरक्षा बायपास करने के लिए उपयोग न करें। स्थानीय कानून और ऐप की शर्तों का पालन करें। दुरुपयोग की ज़िम्मेदारी उपयोगकर्ता की है।
+
+Android अनपैकिंग + smali विश्लेषण **MCP Server**। Cursor / Claude से डिवाइस प्रबंधन, पैकर डिटेक्ट, static / BlackDex / Frida अनपैक, dex→smali और API स्ट्रिंग खोज।
+
+Repo: [https://github.com/TimeCyber/DexAndroid](https://github.com/TimeCyber/DexAndroid)
+
+---
+
+## विशेषताएँ
+
+| क्षमता | MCP टूल | नोट्स |
+| --- | --- | --- |
+| Devices | `list_devices` | Connected ADB devices |
+| Packages | `list_packages` | Optional keyword filter |
+| Packer detect | `detect_packer` | 360 / Tencent / Bangcle / ijiami / Alibaba, etc. |
+| Pull APK | `pull_apk` | Installed app (+ splits) |
+| Static unpack | `static_unpack` | Extract `classes*.dex` |
+| No-Root unpack | `blackdex_prepare` / `blackdex_pull` | BlackDex memory dump |
+| Root unpack | `frida_prepare` / `frida_unpack` | frida-server + frida-dexdump |
+| Decompile | `dex_to_smali` | baksmali → smali |
+| Analyze | `smali_list_classes` / `smali_read_class` / `smali_search` | List / read / regex |
+
+### अनपैक विधियाँ
+
+| विधि | Root? | कब |
+| --- | --- | --- |
+| Static | No | Unpacked apps or shell/resources only |
+| BlackDex | No | Most protected apps |
+| Frida | **Yes** | Strong packers / fuller dumps |
+
+---
+
+## आवश्यकताएँ
+
+- **Windows / macOS / Linux** (docs use Windows examples)
+- **Node.js** ≥ 18
+- **ADB** on PATH, or set `ADB_PATH`
+- **Java 8+** (for baksmali via `dex_to_smali`)
+- Optional: [BlackDex](https://github.com/CodingGay/BlackDex/releases); rooted device + `frida-server`; `pip install frida-tools frida-dexdump`
+
+Place baksmali fat jar / frida-server / BlackDex under local `tools/` (large binaries are gitignored).
+
+---
+
+## इंस्टॉल और बिल्ड
+
+```bash
+git clone https://github.com/TimeCyber/DexAndroid.git
+cd DexAndroid
+npm install
+npm run build
+```
+
+MCP शुरू करें (stdio):
+
+```bash
+npm start
+# node dist/index.js
+```
+
+डेव मोड:
+
+```bash
+npm run dev
+```
+
+---
+
+## Cursor MCP सेटअप
+
+`.cursor/mcp.json` में जोड़ें (**पथ बदलें**):
+
+```json
+{
+  "mcpServers": {
+    "dex-android-unpack": {
+      "command": "node",
+      "args": ["E:/DexAndroid/dist/index.js"],
+      "env": {
+        "ADB_PATH": "E:/Android/Sdk/platform-tools/adb.exe",
+        "DEX_OUT_DIR": "E:/DexAndroid/unpack-output"
+      }
+    }
+  }
+}
+```
+
+Cursor रीस्टार्ट / MCP रीलोड करें।
+
+---
+
+## एनवायरनमेंट वेरिएबल
+
+| वेरिएबल | अर्थ | डिफ़ॉल्ट |
+| --- | --- | --- |
+| `ADB_PATH` | adb executable | `adb` |
+| `DEX_OUT_DIR` | Default output dir | `<cwd>/unpack-output` |
+| `BAKSMALI_JAR` | baksmali jar | auto-discover under `tools/` |
+
+---
+
+## सामान्य वर्कफ़्लो
+
+### 1. स्टैटिक अनपैक (सबसे तेज़)
+
+1. `list_devices` or prepare local `apkPath`.
+2. `detect_packer`.
+3. `static_unpack` → `classes*.dex`.
+4. `dex_to_smali` → smali folder.
+5. `smali_search` / `smali_read_class`.
+
+**Note:** Protected apps often yield only the shell via static unpack—use BlackDex / Frida for business code.
+
+### 2. बिना Root (BlackDex)
+
+1. `list_devices`.
+2. `blackdex_prepare` with `blackdexApkPath`.
+3. Unpack the target app in BlackDex UI.
+4. `blackdex_pull` with `targetPkg`.
+5. `dex_to_smali` then `smali_*`.
+
+### 3. Root के साथ (Frida)
+
+1. Rooted device (e.g. Magisk), `adb` ready.
+2. `frida_prepare` to push/start `tools/frida-server`.
+3. Matching `frida` / `frida-dexdump` locally (prefer 16.x).
+4. `frida_unpack` with `pkg`, prefer `spawn: true`, `deepSearch: true`.
+5. `dex_to_smali` on output, then analyze.
+
+If Frida 17 attach fails, align tools to 16.x; some devices need temporary `setenforce 0`.
+
+### 4. smali उदाहरण
+
+```text
+smali_list_classes  smaliDir=.../smali  keyword=login
+smali_search        smaliDir=.../smali  pattern=https?://|/api/|publicClient/
+smali_read_class    smaliDir=.../smali  className=com.example.api.ApiService
+```
+
+---
+
+## संरचना
+
+```text
+DexAndroid/
+├── src/                 # MCP server (TypeScript)
+│   ├── index.ts
+│   ├── adb.ts
+│   ├── detect.ts
+│   ├── smali.ts
+│   └── unpack/
+├── dist/
+├── examples/            # Damai / Huaxi sample smali.zip + docs
+├── tools/               # baksmali / frida-server / BlackDex (local)
+├── unpack-output/       # local dumps (gitignored)
+├── package.json
+└── README.md
+```
+
+---
+
+## डीकंपाइल उदाहरण
+
+[`examples/`](./examples/) देखें (smali zip में):
+
+| नमूना | पथ | सामग्री |
+| --- | --- | --- |
+| Damai | [`examples/damai/`](./examples/damai/) | Frida smali.zip + API docs |
+| Huaxi Maternity | [`examples/huaxi/`](./examples/huaxi/) | Static smali.zip (`info.cd120.two`) |
+
+अनज़िप के बाद `smali_*` चलाएँ।
+
+---
+
+## MCP टूल चीटशीट
+
+| Tool | Params |
+| --- | --- |
+| `detect_packer` | `apkPath` or `pkg`, optional `serial` |
+| `pull_apk` | `pkg`, optional `outDir` / `serial` |
+| `static_unpack` | `apkPath` or `pkg`, optional `outDir` |
+| `blackdex_prepare` | `blackdexApkPath`, optional `serial` |
+| `blackdex_pull` | `targetPkg`, optional `outDir` / `serial` |
+| `frida_prepare` | optional `serial` / `serverLocalPath` |
+| `frida_unpack` | `pkg`, optional `spawn` / `deepSearch` / `outDir` |
+| `dex_to_smali` | `dexInput`, optional `outDir` |
+| `smali_list_classes` | `smaliDir`, optional `keyword` |
+| `smali_read_class` | `smaliDir`, `className` |
+| `smali_search` | `smaliDir`, `pattern`, optional `flags` / `maxResults` |
+
+---
+
+## FAQ
+
+**Q: Empty `list_devices`?**  
+Check USB debugging, `adb devices`, pass `serial` if multiple.
+
+**Q: No business classes after static unpack?**  
+Likely packed—use BlackDex or Frida.
+
+**Q: `dex_to_smali` failed?**  
+Install Java; put baksmali jar in `tools/` or set `BAKSMALI_JAR`.
+
+**Q: Frida jailed / version mismatch?**  
+Keep `frida-server` and host `frida` major versions aligned; try 16.x.
+
+**Q: Where is output?**  
+Default `unpack-output/` (or `DEX_OUT_DIR`). **Do not commit dumps.**
+
+---
+
+## कानूनी अस्वीकरण
+
+यह प्रोजेक्ट **केवल सीखने, शिक्षण और अधिकृत सुरक्षा अनुसंधान** के लिए है। किसी भी आपराधिक/अवैध उपयोग (अनधिकृत पहुँच, क्रैकिंग, पायरेसी, हमले, IP उल्लंघन) पर सख्त प्रतिबंध है। दुरुपयोग के लिए लेखक उत्तरदायी नहीं। उपयोग का अर्थ इन शर्तों से सहमति है।
+
+> ⚠️ **केवल सीखने और शिक्षण के लिए।** किसी भी अवैध गतिविधि, अनधिकृत क्रैकिंग, कॉपीराइट उल्लंघन या दूसरों की सुरक्षा बायपास करने के लिए उपयोग न करें। स्थानीय कानून और ऐप की शर्तों का पालन करें। दुरुपयोग की ज़िम्मेदारी उपयोगकर्ता की है।
+
+---
+
+## License
+
+MIT — see [`LICENSE`](./LICENSE).

package/README.id.md

@@ -0,0 +1,226 @@
+# DexAndroid
+
+[English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [日本語](./README.ja.md) · [한국어](./README.ko.md) · [Español](./README.es.md) · [Français](./README.fr.md) · [Deutsch](./README.de.md) · [Português](./README.pt-BR.md) · [Русский](./README.ru.md) · [العربية](./README.ar.md) · [हिन्दी](./README.hi.md) · **Bahasa Indonesia** · [Tiếng Việt](./README.vi.md) · [ไทย](./README.th.md) · [Italiano](./README.it.md) · [Türkçe](./README.tr.md)
+
+> ⚠️ **Hanya untuk belajar dan mengajar.** Jangan gunakan untuk kegiatan ilegal, cracking tanpa izin, pelanggaran hak cipta, atau melewati proteksi pihak lain. Patuhi hukum setempat dan syarat aplikasi. Penyalahgunaan menjadi tanggung jawab pengguna.
+
+**MCP Server** unpacking Android + analisis smali. Dari Cursor / Claude: perangkat, deteksi packer, unpack statis / BlackDex / Frida, dex→smali, pencarian string API.
+
+Repo: [https://github.com/TimeCyber/DexAndroid](https://github.com/TimeCyber/DexAndroid)
+
+---
+
+## Fitur
+
+| Kemampuan | Alat MCP | Catatan |
+| --- | --- | --- |
+| Devices | `list_devices` | Connected ADB devices |
+| Packages | `list_packages` | Optional keyword filter |
+| Packer detect | `detect_packer` | 360 / Tencent / Bangcle / ijiami / Alibaba, etc. |
+| Pull APK | `pull_apk` | Installed app (+ splits) |
+| Static unpack | `static_unpack` | Extract `classes*.dex` |
+| No-Root unpack | `blackdex_prepare` / `blackdex_pull` | BlackDex memory dump |
+| Root unpack | `frida_prepare` / `frida_unpack` | frida-server + frida-dexdump |
+| Decompile | `dex_to_smali` | baksmali → smali |
+| Analyze | `smali_list_classes` / `smali_read_class` / `smali_search` | List / read / regex |
+
+### Metode unpack
+
+| Metode | Root? | Kapan |
+| --- | --- | --- |
+| Static | No | Unpacked apps or shell/resources only |
+| BlackDex | No | Most protected apps |
+| Frida | **Yes** | Strong packers / fuller dumps |
+
+---
+
+## Persyaratan
+
+- **Windows / macOS / Linux** (docs use Windows examples)
+- **Node.js** ≥ 18
+- **ADB** on PATH, or set `ADB_PATH`
+- **Java 8+** (for baksmali via `dex_to_smali`)
+- Optional: [BlackDex](https://github.com/CodingGay/BlackDex/releases); rooted device + `frida-server`; `pip install frida-tools frida-dexdump`
+
+Place baksmali fat jar / frida-server / BlackDex under local `tools/` (large binaries are gitignored).
+
+---
+
+## Instalasi & build
+
+```bash
+git clone https://github.com/TimeCyber/DexAndroid.git
+cd DexAndroid
+npm install
+npm run build
+```
+
+Jalankan MCP (stdio):
+
+```bash
+npm start
+# node dist/index.js
+```
+
+Mode dev:
+
+```bash
+npm run dev
+```
+
+---
+
+## Setup Cursor (MCP)
+
+Tambahkan ke `.cursor/mcp.json` (**sesuaikan path**):
+
+```json
+{
+  "mcpServers": {
+    "dex-android-unpack": {
+      "command": "node",
+      "args": ["E:/DexAndroid/dist/index.js"],
+      "env": {
+        "ADB_PATH": "E:/Android/Sdk/platform-tools/adb.exe",
+        "DEX_OUT_DIR": "E:/DexAndroid/unpack-output"
+      }
+    }
+  }
+}
+```
+
+Restart Cursor / reload MCP.
+
+---
+
+## Variabel lingkungan
+
+| Variabel | Arti | Default |
+| --- | --- | --- |
+| `ADB_PATH` | adb executable | `adb` |
+| `DEX_OUT_DIR` | Default output dir | `<cwd>/unpack-output` |
+| `BAKSMALI_JAR` | baksmali jar | auto-discover under `tools/` |
+
+---
+
+## Alur tipikal
+
+### 1. Unpack statis (tercepat)
+
+1. `list_devices` or prepare local `apkPath`.
+2. `detect_packer`.
+3. `static_unpack` → `classes*.dex`.
+4. `dex_to_smali` → smali folder.
+5. `smali_search` / `smali_read_class`.
+
+**Note:** Protected apps often yield only the shell via static unpack—use BlackDex / Frida for business code.
+
+### 2. Tanpa Root (BlackDex)
+
+1. `list_devices`.
+2. `blackdex_prepare` with `blackdexApkPath`.
+3. Unpack the target app in BlackDex UI.
+4. `blackdex_pull` with `targetPkg`.
+5. `dex_to_smali` then `smali_*`.
+
+### 3. Dengan Root (Frida)
+
+1. Rooted device (e.g. Magisk), `adb` ready.
+2. `frida_prepare` to push/start `tools/frida-server`.
+3. Matching `frida` / `frida-dexdump` locally (prefer 16.x).
+4. `frida_unpack` with `pkg`, prefer `spawn: true`, `deepSearch: true`.
+5. `dex_to_smali` on output, then analyze.
+
+If Frida 17 attach fails, align tools to 16.x; some devices need temporary `setenforce 0`.
+
+### 4. Contoh smali
+
+```text
+smali_list_classes  smaliDir=.../smali  keyword=login
+smali_search        smaliDir=.../smali  pattern=https?://|/api/|publicClient/
+smali_read_class    smaliDir=.../smali  className=com.example.api.ApiService
+```
+
+---
+
+## Struktur
+
+```text
+DexAndroid/
+├── src/                 # MCP server (TypeScript)
+│   ├── index.ts
+│   ├── adb.ts
+│   ├── detect.ts
+│   ├── smali.ts
+│   └── unpack/
+├── dist/
+├── examples/            # Damai / Huaxi sample smali.zip + docs
+├── tools/               # baksmali / frida-server / BlackDex (local)
+├── unpack-output/       # local dumps (gitignored)
+├── package.json
+└── README.md
+```
+
+---
+
+## Contoh dekompilasi
+
+Lihat [`examples/`](./examples/) (smali sebagai zip):
+
+| Contoh | Path | Isi |
+| --- | --- | --- |
+| Damai | [`examples/damai/`](./examples/damai/) | Frida smali.zip + API docs |
+| Huaxi Maternity | [`examples/huaxi/`](./examples/huaxi/) | Static smali.zip (`info.cd120.two`) |
+
+Setelah unzip, jalankan `smali_*`.
+
+---
+
+## Cheatsheet alat MCP
+
+| Tool | Params |
+| --- | --- |
+| `detect_packer` | `apkPath` or `pkg`, optional `serial` |
+| `pull_apk` | `pkg`, optional `outDir` / `serial` |
+| `static_unpack` | `apkPath` or `pkg`, optional `outDir` |
+| `blackdex_prepare` | `blackdexApkPath`, optional `serial` |
+| `blackdex_pull` | `targetPkg`, optional `outDir` / `serial` |
+| `frida_prepare` | optional `serial` / `serverLocalPath` |
+| `frida_unpack` | `pkg`, optional `spawn` / `deepSearch` / `outDir` |
+| `dex_to_smali` | `dexInput`, optional `outDir` |
+| `smali_list_classes` | `smaliDir`, optional `keyword` |
+| `smali_read_class` | `smaliDir`, `className` |
+| `smali_search` | `smaliDir`, `pattern`, optional `flags` / `maxResults` |
+
+---
+
+## FAQ
+
+**Q: Empty `list_devices`?**  
+Check USB debugging, `adb devices`, pass `serial` if multiple.
+
+**Q: No business classes after static unpack?**  
+Likely packed—use BlackDex or Frida.
+
+**Q: `dex_to_smali` failed?**  
+Install Java; put baksmali jar in `tools/` or set `BAKSMALI_JAR`.
+
+**Q: Frida jailed / version mismatch?**  
+Keep `frida-server` and host `frida` major versions aligned; try 16.x.
+
+**Q: Where is output?**  
+Default `unpack-output/` (or `DEX_OUT_DIR`). **Do not commit dumps.**
+
+---
+
+## Pernyataan hukum
+
+Proyek ini **hanya untuk pembelajaran, pengajaran, dan riset keamanan yang diizinkan**. Dilarang keras untuk kejahatan atau ilegalitas (akses tanpa izin, cracking, pembajakan, serangan, pelanggaran IP). Penulis tidak bertanggung jawab atas penyalahgunaan. Dengan menggunakan, Anda menyetujui syarat ini.
+
+> ⚠️ **Hanya untuk belajar dan mengajar.** Jangan gunakan untuk kegiatan ilegal, cracking tanpa izin, pelanggaran hak cipta, atau melewati proteksi pihak lain. Patuhi hukum setempat dan syarat aplikasi. Penyalahgunaan menjadi tanggung jawab pengguna.
+
+---
+
+## License
+
+MIT — see [`LICENSE`](./LICENSE).