Skip to content
Back to search

jadx-ai-mcp

Plugin for JADX to integrate MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zinja-coder--jadx-ai-mcp/badge.svg)](/listings/zinja-coder--jadx-ai-mcp)

HTML

<a href="/listings/zinja-coder--jadx-ai-mcp"><img src="/api/listings/zinja-coder--jadx-ai-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

1. Download from Releases: https://github.com/zinja-coder/jadx-ai-mcp/releases

> [!NOTE] > > Download both `jadx-ai-mcp-<version>.jar` and `jadx-mcp-server-<version>.zip` files.

# 0. Download the jadx-ai-mcp-<version>.jar and jadx-mcp-server-<version>.zip
https://github.com/zinja-coder/jadx-ai-mcp/releases

# 1. 
unzip jadx-ai-mcp-<version>.zip

├jadx-mcp-server/
  ├── jadx_mcp.py
  ├── requirements.txt
  ├── README.md
  ├── LICENSE

├jadx-ai-mcp-<version>.jar

# 2. Install the plugin

# For this you can follow two approaches:

## 1. One liner - execute below command in your shell
jadx plugins --install "github:zinja-coder:jadx-ai-mcp"

## The above one line code will install the latest version of the plugin directly into the jadx, no need to download the jadx-ai-mcp's .jar file.
## 2. Or you can use JADX-GUI to install it by following images as shown below:

<div align="center"> </div>

<div align="center"> </div>

<div align="center"> </div>

## 3. GUI method, download the .jar file and follow below steps shown in images
# 3. Navigate to jadx-mcp-server directory
cd jadx-mcp-server

# 4. This project uses uv - https://github.com/astral-sh/uv instead of pip for dependency management.
    ## 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

# The setup for jadx-ai-mcp and jadx_mcp_server is done.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 770 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # JADX-AI-MCP (Part of Zin MCP Suite)
  3. ⚡ Fully automated MCP server + JADX plugin built to communicate with LLM through MCP to analyze Android APKs using LLMs like Claude — uncover vulnerabilities, analyze APK, and reverse engineer effortlessly.
  4. ![GitHub contributors JADX-AI-MCP](https://img.shields.io/github/contributors/zinja-coder/jadx-ai-mcp)
  5. ![GitHub contributors JADX-MCP-SERVER](https://img.shields.io/github/contributors/zinja-coder/jadx-mcp-server)
  6. ![GitHub all releases](https://img.shields.io/github/downloads/zinja-coder/jadx-ai-mcp/total)
  7. ![GitHub release (latest by SemVer)](https://img.shields.io/github/downloads/zinja-coder/jadx-ai-mcp/latest/total)
  8. ![Latest release](https://img.shields.io/github/release/zinja-coder/jadx-ai-mcp.svg)
  9. ![Java 11+](https://img.shields.io/badge/Java-11%2B-blue)
  10. ![Python 3.10+](https://img.shields.io/badge/python-3%2E10%2B-blue)
  11. [![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
  12. #### ⭐ Contributors
  13. Thanks to these wonderful people for their contributions ⭐
  14. <table>
  15. <tr align="center">
  16. <td>
  17. <a href="https://github.com/ljt270864457">
  18. <img src="https://avatars.githubusercontent.com/u/8609890?v=4" width="30px;" alt=""/>
  19. <br /><sub><b>ljt270864457</b></sub>
  20. </a>
  21. </td>
  22. <td>
  23. <a href="https://github.com/p0px">
  24. <img src="https://avatars.githubusercontent.com/u/161268024?v=4" width="30px;" alt=""/>
  25. <br /><sub><b>p0px</b></sub>
  26. </a>
  27. </td>
  28. <td>
  29. <a href="https://github.com/bx33661">
  30. <img src="https://avatars.githubusercontent.com/u/138348615?v=4" width="30px;" alt=""/>
  31. <br /><sub><b>bx33661</b></sub>
  32. </a>
  33. </td>
  34. <td>
  35. <a href="https://github.com/Haicaji">
  36. <img src="https://avatars.githubusercontent.com/u/132796021?v=4" width="30px;" alt=""/>
  37. <br /><sub><b>Haicaji</b></sub>
  38. </a>
  39. </td>
  40. <td>
  41. <a href="https://github.com/mostafaNazari702">
  42. <img src="https://avatars.githubusercontent.com/u/93077724?v=4" width="30px;" alt=""/>
  43. <br /><sub><b>Mostafa Nazari</b></sub>
  44. </a>
  45. </td>
  46. <td>
  47. <a href="https://github.com/ChineseAStar">
  48. <img src="https://avatars.githubusercontent.com/u/24355243?v=4" width="30px;" alt=""/>
  49. <br /><sub><b>ChineseAStar</b></sub>
  50. </a>
  51. </td>
  52. <td>
  53. <a href="https://github.com/cyal1r">
  54. <img src="https://avatars.githubusercontent.com/u/33282478?v=4" width="30px;" alt=""/>
  55. <br /><sub><b>cyal1</b></sub>
  56. </a>
  57. </td>
  58. <td>
  59. <a href="https://github.com/badmonkey7">
  60. <img src="https://avatars.githubusercontent.com/u/41368882?v=4" width="30px;" alt=""/>
  61. <br /><sub><b>badmonkey7</b></sub>
  62. </a>
  63. </td>
  64. <td>
  65. <a href="https://github.com/tiann">
  66. <img src="https://avatars.githubusercontent.com/u/4233744?v=4" width="30px;" alt=""/>
  67. <br /><sub><b>tiann</b></sub>
  68. </a>
  69. </td>
  70. <td>
  71. <a href="https://github.com/ZERO-A-ONE">
  72. <img src="https://avatars.githubusercontent.com/u/18625356?v=4" width="30px;" alt=""/>
  73. <br /><sub><b>ZERO-A-ONE</b></sub>
  74. </a>
  75. </td>
  76. <td>
  77. <a href="https://github.com/neoz">
  78. <img src="https://avatars.githubusercontent.com/u/360582?v=4" width="30px;" alt=""/>
  79. <br /><sub><b>neoz</b></sub>
  80. </a>
  81. </td>
  82. <td>
  83. <a href="https://github.com/SamadiPour">
  84. <img src="https://avatars.githubusercontent.com/u/24422125?v=4" width="30px;" alt=""/>
  85. <br /><sub><b>SamadiPour</b></sub>
  86. </a>
  87. </td>
  88. <td>
  89. <a href="https://github.com/wuseluosi">
  90. <img src="https://avatars.githubusercontent.com/u/192840340?v=4" width="30px;" alt=""/>
  91. <br /><sub><b>wuseluosi</b></sub>
  92. </a>
  93. </td>
  94. <td>
  95. <a href="https://github.com/CainYzb">
  96. <img src="https://avatars.githubusercontent.com/u/50669073?v=4" width="30px;" alt=""/>
  97. <br /><sub><b>CainYzb</b></sub>
  98. </a>
  99. </td>
  100. <td>
  101. <a href="https://github.com/tbodt">
  102. <img src="https://avatars.githubusercontent.com/u/5678977?v=4" width="30px;" alt=""/>
  103. <br /><sub><b>tbodt</b></sub>
  104. </a>
  105. </td>
  106. <td>
  107. <a href="https://github.com/LilNick0101">
  108. <img src="https://avatars.githubusercontent.com/u/100995805?v=4" width="30px;" alt=""/>
  109. <br /><sub><b>LilNick0101</b></sub>
  110. </a>
  111. </td>
  112. <td>
  113. <a href="https://github.com/lwsinclair">
  114. <img src="https://avatars.githubusercontent.com/u/2829939?v=4" width="30px;" alt=""/>
  115. <br /><sub><b>lwsinclair</b></sub>
  116. </a>
  117. </td>
  118. </tr>
  119. <tr align="center">
  120. <td>
  121. <a href="https://github.com/LYC-Android">
  122. <img src="https://avatars.githubusercontent.com/u/18358825?v=4" width="30px;" alt=""/>
  123. <br /><sub><b>LYC-Android</b></sub>
  124. </a>
  125. </td>
  126. <td>
  127. <a href="https://github.com/zbhello">
  128. <img src="https://avatars.githubusercontent.com/u/122980705?v=4" width="30px;" alt=""/>
  129. <br /><sub><b>zbhello</b></sub>
  130. </a>
  131. </td>
  132. <td>
  133. <a href="https://github.com/1yearning1">
  134. <img src="https://avatars.githubusercontent.com/u/297883149?v=4" width="30px;" alt=""/>
  135. <br /><sub><b>1yearning1</b></sub>
  136. </a>
  137. </td>
  138. <td>
  139. <a href="https://github.com/mhsjzsq">
  140. <img src="https://avatars.githubusercontent.com/u/116739454?v=4" width="30px;" alt=""/>
  141. <br /><sub><b>mhsjzsq</b></sub>
  142. </a>
  143. </td>
  144. <td>
  145. <a href="https://github.com/darkblack1234">
  146. <img src="https://avatars.githubusercontent.com/u/139411545?v=4" width="30px;" alt=""/>
  147. <br /><sub><b>darkblack1234</b></sub>
  148. </a>
  149. </td>
  150. <td>
  151. <a href="https://github.com/Merrg1n">
  152. <img src="https://avatars.githubusercontent.com/u/22628584?v=4" width="30px;" alt=""/>
  153. <br /><sub><b>Merrg1n</b></sub>
  154. </a>
  155. </td>
  156. </tr>
  157. </table>
  158. </div>
  159. <!-- It is a still in early stage of development, so expects bugs, crashes and logical erros.-->
  160. <!-- Standalone Plugin for [JADX](https://github.com/skylot/jadx) (Started as Fork) with Model Context Protocol (MCP) integration for AI-powered static code analysis and real-time code review and reverse engineering tasks using Claude.-->
  161. <div align="center">
  162. <img alt="banner" height="480px" widht="620px" src="docs/assets/img.png">
  163. </div>
  164. <!-- ![jadx-ai-banner.png](docs/assets/img.png) Image generated using AI tools. -->
  165. #### Read The Docs
  166. - Read The Docs is now live: https://jadx-ai-mcp.readthedocs.io/en/latest/
  167. ---
  168. ## 🤖 What is JADX-AI-MCP?
  169. **JADX-AI-MCP** is a plugin for the [JADX decompiler](https://github.com/skylot/jadx) that integrates directly with [Model Context Protocol (MCP)](https://github.com/anthropic/mcp) to provide **live reverse engineering support with LLMs like Claude**.
  170. Think: "Decompile → Context-Aware Code Review → AI Recommendations" — all in real time.
  171. #### High Level Sequence Diagram
  172. ```mermaid
  173. sequenceDiagram
  174. LLM CLIENT->>JADX MCP SERVER: INVOKE MCP TOOL
  175. JADX MCP SERVER->>JADX AI MCP PLUGIN: INVOKE HTTP REQUEST
  176. JADX AI MCP PLUGIN->>REQUEST HANDLERS: INVOKE HTTP REQUEST HANDLER
  177. REQUEST HANDLERS->>JADX GUI: PERFORM ACTION/GATHER DATA
  178. JADX GUI->>REQUEST HANDLERS: ACTION PERFORMED/DATA GATHERED
  179. REQUEST HANDLERS->>JADX AI MCP PLUGIN: CRAFT HTTP RESPONSE
  180. JADX AI MCP PLUGIN->>JADX MCP SERVER:HTTP RESPONSE
  181. JADX MCP SERVER->>LLM CLIENT: MCP TOOL RESULT
  182. ```
  183. ### Watch the demos!
  184. - **Perform quick analysis**
  185. https://github.com/user-attachments/assets/b65c3041-fde3-4803-8d99-45ca77dbe30a
  186. - **Quickly find vulnerabilities**
  187. https://github.com/user-attachments/assets/c184afae-3713-4bc0-a1d0-546c1f4eb57f
  188. - **Multiple AI Agents Support**
  189. https://github.com/user-attachments/assets/6342ea0f-fa8f-44e6-9b3a-4ceb8919a5b0
  190. - **Run with your favorite LLM Client**
  191. https://github.com/user-attachments/assets/b4a6b280-5aa9-4e76-ac72-a0abec73b809
  192. - **Analyze The APK Resources**
  193. https://github.com/user-attachments/assets/f42d8072-0e3e-4f03-93ea-121af4e66eb1
  194. - **Your AI Assistant during debugging of APK using JADX**
  195. https://github.com/user-attachments/assets/2b0bd9b1-95c1-4f32-9b0c-38b864dd6aec
  196. It is combination of two tools:
  197. 1. JADX-AI-MCP
  198. 2. [JADX MCP SERVER](https://github.com/zinja-coder/jadx-mcp-server)
  199. ## 🤖 What is JADX-MCP-SERVER?
  200. **JADX MCP Server** is a standalone Python server that interacts with a `JADX-AI-MCP` plugin (see: [jadx-ai-mcp](https://github.com/zinja-coder/jadx-ai-mcp)) via MCP (Model Context Protocol). It lets LLMs communicate with the decompiled Android app context live.
  201. ---
  202. ## Other projects in Zin MCP Suite
  203. - **[APKTool-MCP-Server](https://github.com/zinja-coder/apktool-mcp-server)**
  204. - **[JADX-MCP-Server](https://github.com/zinja-coder/jadx-mcp-server)**
  205. - **[ZIN-MCP-Client](https://github.com/zinja-coder/zin-mcp-client)**
  206. ## Current MCP Tools
  207. The following MCP tools are available:
  208. - `fetch_current_class()` — Get the class name and full source of selected class
  209. - `get_selected_text()` — Get currently selected text
  210. - `get_all_classes()` — List all classes in the project
  211. - `get_class_source()` — Get full source of a given class
  212. - `get_method_by_name()` — Fetch a method's source
  213. - `search_method_by_name()` — Search method across classes
  214. - `search_classes_by_keyword()` — Search for classes whose source code contains a specific keyword (supports pagination)
  215. - `get_methods_of_class()` — List methods in a class
  216. - `get_fields_of_class()` — List fields in a class
  217. - `get_smali_of_class()` — Fetch smali of class
  218. - `get_main_activity_class()` — Fetch main activity from jadx mentioned in AndroidManifest.xml file.
  219. - `get_main_application_classes_code()` — Fetch all the main application classes' code based on the package name defined in the AndroidManifest.xml.
  220. - `get_main_application_classes_names()` — Fetch all the main application classes' names based on the package name defined in the AndroidManifest.xml.
  221. - `get_android_manifest()` — Retrieve and return the AndroidManifest.xml content.
  222. - `get_manifest_component` - Retrieve specific manifest component instead of whole manifest file
  223. - `get_strings()` : Fetches the strings.xml file
  224. - `get_all_resource_file_names()` : Retrieve all resource files names that exists in application
  225. - `get_resource_file()` : Retrieve resource file content
  226. - `rename_class()` : Renames the class name
  227. - `rename_method()` : Renames the method
  228. - `rename_field()` : Renames the field
  229. - `rename_package()` : Renames whole package
  230. - `rename_variable()` : Renames the variable within a method
  231. - `add_comment()` : Adds a comment to a class, method, field, or a single code line (`line=`, the 1-based line number of the decompiled source), shown in JADX-GUI and saved with the project (re-commenting the same target updates it, an empty comment removes it)
  232. - `list_comments()` : Lists the comments stored in the project, optionally filtered to one class
  233. - `debug_get_stack_frames()` : Get the stack frames from jadx debugger
  234. - `debug_get_threads()` : Get the insights of threads from jadx debugger
  235. - `debug_get_variables()` : Get the variables from jadx debugger
  236. - `xrefs_to_class()` : Find all references to a class (returns method-level and class-level references, supports pagination)
  237. - `xrefs_to_method()` : Find all references to a method (includes override-related methods, supports pagination)
  238. - `xrefs_to_field()` : Find all references to a field (returns methods that access the field, supports pagination)
  239. ---
  240. ## 🗒️ Sample Prompts
  241. 🔍 Basic Code Understanding
  242. "Explain what this class does in one paragraph."
  243. "Summarize the responsibilities of this method."
  244. "Is there any obfuscation in this class?"
  245. "List all Android permissions this class might require."
  246. 🛡️ Vulnerability Detection
  247. "Are there any insecure API usages in this method?"
  248. "Check this class for hardcoded secrets or credentials."
  249. "Does this method sanitize user input before using it?"
  250. "What security vulnerabilities might be introduced by this code?"
  251. 🛠️ Reverse Engineering Helpers
  252. "Deobfuscate and rename the classes and methods to something readable."
  253. "Can you infer the original purpose of this smali method?"
  254. "What libraries or SDKs does this class appear to be part of?"
  255. "Tell me which classes contains code related to 'encryption'?"
  256. 📦 Static Analysis
  257. "List all network-related API calls in this class."
  258. "Identify file I/O operations and their potential risks."
  259. "Does this method leak device info or PII?"
  260. 🤖 AI Code Modification
  261. "Refactor this method to improve readability."
  262. "Add comments to this code explaining each step."
  263. "Rewrite this Java method in Python for analysis."
  264. 📄 Documentation & Metadata
  265. "Generate Javadoc-style comments for all methods."
  266. "What package or app component does this class likely belong to?"
  267. "Can you identify the Android component type (Activity, Service, etc.)?"
  268. 🐞 Debugger Assistant
  269. ```
  270. "Fetch stack frames, varirables and threads from debugger and provide summary"
  271. "Based the stack frames from debugger, explain the execution flow of the application"
  272. "Based on the state of variables, is there security threat?"
  273. ```
  274. ---
  275. ## 🛠️ Getting Started
  276. ### 1. Download from Releases: https://github.com/zinja-coder/jadx-ai-mcp/releases
  277. > [!NOTE]
  278. >
  279. > Download both `jadx-ai-mcp-<version>.jar` and `jadx-mcp-server-<version>.zip` files.
  280. ```bash
  281. # 0. Download the jadx-ai-mcp-<version>.jar and jadx-mcp-server-<version>.zip
  282. https://github.com/zinja-coder/jadx-ai-mcp/releases
  283. # 1.
  284. unzip jadx-mcp-server-<version>.zip
  285. ├jadx-mcp-server/
  286. ├── jadx_mcp_server.py
  287. ├── requirements.txt
  288. ├── README.md
  289. ├── LICENSE
  290. ├── src/
  291. ├── static/
  292. ├── examples/
  293. └── test.sh
  294. ├jadx-ai-mcp-<version>.jar
  295. # 2. Install the plugin
  296. # For this you can follow two approaches:
  297. ## 1. One liner - execute below command in your shell
  298. jadx plugins --install "github:zinja-coder:jadx-ai-mcp"
  299. ## The above one line code will install the latest version of the plugin directly into the jadx, no need to download the jadx-ai-mcp's .jar file.
  300. ## 2. Or you can use JADX-GUI to install it by following images as shown below:
  301. ```
  302. <div align="center">
  303. <img alt="banner" height="480px" widht="620px" src="docs/assets/img_1231.png">
  304. </div>
  305. <div align="center">
  306. <img alt="banner" height="480px" widht="620px" src="docs/assets/img_1123.png">
  307. </div>
  308. <div align="center">
  309. <img alt="banner" height="480px" widht="620px" src="docs/assets/img_2122.png">
  310. </div>
  311. ```bash
  312. ## 3. GUI method, download the .jar file and follow below steps shown in images
  313. ```
  314. ![img.png](docs/assets/img123.png)
  315. ![img_1.png](docs/assets/img_12.png)
  316. ![img_2.png](docs/assets/img_2.png)
  317. ![img_3.png](docs/assets/img_3.png)
  318. ```bash
  319. # 3. Navigate to jadx-mcp-server directory
  320. cd jadx-mcp-server
  321. # 4. This project uses uv - https://github.com/astral-sh/uv instead of pip for dependency management.
  322. ## a. Install uv (if you dont have it yet)
  323. curl -LsSf https://astral.sh/uv/install.sh | sh
  324. ## b. OPTIONAL, if for any reasons, you get dependecy errors in jadx-mcp-server, Set up the environment
  325. uv venv
  326. source .venv/bin/activate # or .venv\Scripts\activate on Windows
  327. ## c. OPTIONAL Install dependencies
  328. uv pip install httpx fastmcp
  329. # The setup for jadx-ai-mcp and jadx_mcp_server is done.
  330. ```
  331. ## 🤖 2. Use Claude Desktop
  332. Make sure Claude Desktop is running with MCP enabled.
  333. For instance, I have used following for Kali Linux: https://github.com/aaddrick/claude-desktop-debian
  334. Configure and add MCP server to LLM file:
  335. ```bash
  336. nano ~/.config/Claude/claude_desktop_config.json
  337. ```
  338. For:
  339. - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
  340. - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  341. And following content in it:
  342. ```json
  343. {
  344. "mcpServers": {
  345. "jadx-mcp-server": {
  346. "command": "/<path>/<to>/uv",
  347. "args": [
  348. "--directory",
  349. "</PATH/TO/>jadx-mcp-server/",
  350. "run",
  351. "jadx_mcp_server.py"
  352. ]
  353. }
  354. }
  355. }
  356. ```
  357. Replace:
  358. - `path/to/uv` with the actual path to your `uv` executable
  359. - `path/to/jadx-mcp-server` with the absolute path to where you cloned this
  360. repository
  361. Then, navigate code and interact via real-time code review prompts using the built-in integration.
  362. **OR**
  363. or you can install the jadx_mcp_server directly as executable directly using below command:
  364. ```
  365. uv tool install git+https://github.com/zinja-coder/jadx-mcp-server
  366. ```
  367. and then you can just provide `jadx_mcp_server` in `command` section of mcp configuration.
  368. ## 3. Use Cherry Studio
  369. If you want to configure the MCP tool in Cherry Studio, you can refer to the following configuration.
  370. - Type: stdio
  371. - command: uv
  372. - argument:
  373. ```bash
  374. --directory
  375. path/to/jadx-mcp-server
  376. run
  377. jadx_mcp_server.py
  378. ```
  379. - `path/to/jadx-mcp-server` with the absolute path to where you cloned this
  380. repository
  381. ## 4. Using LMStudio
  382. You can also use JADX AI MCP Server with LM Studio by configuring it's mcp.json file. Here's the video guide.
  383. https://github.com/user-attachments/assets/b4a6b280-5aa9-4e76-ac72-a0abec73b809
  384. ## 5. Running in HTTP Stream Mode
  385. You can also use Jadx in HTTP Stream Mode using `--http` option with `jadx_mcp_server.py` as shown in following:
  386. ```bash
  387. uv run jadx_mcp_server.py --http
  388. OR
  389. uv run jadx_mcp_server.py --http --port 9999
  390. ```
  391. ### Advanced CLI Options — Understanding the Flags
  392. There are **two separate connections** and each has its own host/port:
  393. ```
  394. ┌─────────────┐ --host / --port ┌──────────────────┐ --jadx-host / --jadx-port ┌──────────────────┐
  395. │ LLM Client │ ◄──────────────────► │ jadx-mcp-server │ ──────────────────────────► │ JADX-GUI Plugin │
  396. │ (Claude, │ Where the MCP server │ │ Where the MCP server looks │ (jadx-ai-mcp) │
  397. │ Codex..) │ LISTENS for clients │ │ for the JADX plugin │ │
  398. └─────────────┘ └──────────────────┘ └──────────────────┘
  399. ```
  400. | Flag | Default | Controls |
  401. |------|---------|----------|
  402. | `--http` | off | Use HTTP transport instead of stdio |
  403. | `--host` | `127.0.0.1` | **Where the MCP server listens** (bind address for LLM clients) |
  404. | `--port` | `8651` | **Which port the MCP server listens on** |
  405. | `--jadx-host` | `127.0.0.1` | **Where to find the JADX plugin** (the target JADX-GUI machine) |
  406. | `--jadx-port` | `8650` | **Which port the JADX plugin is on** |
  407. ### Usage Examples
  408. **Scenario 1 — Everything on the same machine (most common):**
  409. ```bash
  410. # Default: MCP server on localhost:8651, connects to JADX plugin on localhost:8650
  411. uv run jadx_mcp_server.py --http
  412. ```
  413. **Scenario 2 — Docker container or WSL (MCP server accessible from host network):**
  414. ```bash
  415. # MCP server listens on ALL interfaces so the host can reach it
  416. # JADX plugin is still on the same machine
  417. uv run jadx_mcp_server.py --http --host 0.0.0.0
  418. ```
  419. **Scenario 3 — JADX-GUI running on a different machine (e.g., remote VM):**
  420. ```bash
  421. # MCP server runs locally, but connects to JADX plugin on a remote machine
  422. uv run jadx_mcp_server.py --http --jadx-host 192.168.1.100
  423. ```
  424. **Scenario 4 — Full remote setup (everything on different machines):**
  425. ```bash
  426. # MCP server listens on all interfaces on port 9999
  427. # JADX plugin is on a different machine at 192.168.1.100:8652
  428. uv run jadx_mcp_server.py --http --host 0.0.0.0 --port 9999 --jadx-host 192.168.1.100 --jadx-port 8652
  429. ```
  430. > [!CAUTION]
  431. > ### ⚠️ Security Warning — Remote Binding
  432. >
  433. > When using `--host 0.0.0.0` (or any non-localhost address), the MCP server binds to **all network interfaces** over **plain HTTP with no authentication**. This means:
  434. >
  435. > - **Anyone on the network** can connect and invoke all MCP tools
  436. > - There is **no TLS encryption** — traffic can be intercepted
  437. > - An attacker can use the server to **read decompiled code**, **rename classes/methods**, and **access debug info**
  438. >
  439. > **Mitigations:**
  440. > - Only bind to `0.0.0.0` on **trusted, isolated networks** (e.g., Docker bridge, local VM)
  441. > - Use a **firewall** to restrict access to the MCP port
  442. > - Consider an **SSH tunnel** instead: `ssh -L 8651:127.0.0.1:8651 remote-host`
  443. ### Stdio Mode Compatibility
  444. > [!NOTE]
  445. > When running in **stdio** mode (the default, without `--http`), all human-readable output (banner, health check) is written to **stderr** to keep **stdout** reserved for the MCP JSON-RPC stream. This ensures compatibility with Codex, Claude Desktop, and other stdio-based MCP clients.
  446. ## 6. Custom port and host configuration for JADX AI MCP Plugin
  447. <img width="800" height="335" alt="image" src="https://github.com/user-attachments/assets/6243adc5-5be4-4e2d-aa16-bdaf78a28e36" />
  448. 1. Configure Port: Configure the port on which the JADX AI MCP Plugin will listen on.
  449. 2. Default Port: Revert back the changes and listen on default port.
  450. 3. Restart Server: Force restart the JADX AI MCP Plugin server.
  451. 4. Server Status: Check the status of JADX AI MCP Plugin server.
  452. To connect with JADX AI MCP Plugin running on custom port, the `--jadx-port` option will be used as shown in following:
  453. ```
  454. uv run jadx_mcp_server.py --jadx-port 8652
  455. ```
  456. If the JADX AI MCP Plugin is running on a **different machine** (e.g., JADX on a remote VM, MCP server on your local host), use the `--jadx-host` option:
  457. ```bash
  458. # Connect to JADX plugin on a remote host
  459. uv run jadx_mcp_server.py --jadx-host 192.168.1.100 --jadx-port 8650
  460. ```
  461. ### CLI Reference — Understanding the Flags
  462. There are **two separate connections** and each has its own host/port:
  463. ```
  464. ┌─────────────┐ --host / --port ┌──────────────────┐ --jadx-host / --jadx-port ┌──────────────────┐
  465. │ LLM Client │ ◄──────────────────► │ jadx-mcp-server │ ──────────────────────────► │ JADX-GUI Plugin │
  466. │ (Claude, │ Where the MCP server │ │ Where the MCP server looks │ (jadx-ai-mcp) │
  467. │ Codex..) │ LISTENS for clients │ │ for the JADX plugin │ │
  468. └─────────────┘ └──────────────────┘ └──────────────────┘
  469. ```
  470. | Flag | Default | Controls |
  471. |------|---------|----------|
  472. | `--http` | off | Use HTTP transport instead of stdio |
  473. | `--host` | `127.0.0.1` | **Where the MCP server listens** (bind address for LLM clients) |
  474. | `--port` | `8651` | **Which port the MCP server listens on** |
  475. | `--jadx-host` | `127.0.0.1` | **Where to find the JADX plugin** (the target JADX-GUI machine) |
  476. | `--jadx-port` | `8650` | **Which port the JADX plugin is on** |
  477. ### Usage Examples
  478. **Scenario 1 — Everything on the same machine (most common):**
  479. ```bash
  480. # Default: MCP server on localhost:8651, connects to JADX plugin on localhost:8650
  481. uv run jadx_mcp_server.py --http
  482. ```
  483. **Scenario 2 — Docker container or WSL (MCP server accessible from host network):**
  484. ```bash
  485. # MCP server listens on ALL interfaces so the host can reach it
  486. # JADX plugin is still on the same machine
  487. uv run jadx_mcp_server.py --http --host 0.0.0.0
  488. ```
  489. **Scenario 3 — JADX-GUI running on a different machine (e.g., remote VM):**
  490. ```bash
  491. # MCP server runs locally, but connects to JADX plugin on a remote machine
  492. uv run jadx_mcp_server.py --http --jadx-host 192.168.1.100
  493. ```
  494. **Scenario 4 — Full remote setup (everything on different machines):**
  495. ```bash
  496. # MCP server listens on all interfaces on port 9999
  497. # JADX plugin is on a different machine at 192.168.1.100:8652
  498. uv run jadx_mcp_server.py --http --host 0.0.0.0 --port 9999 --jadx-host 192.168.1.100 --jadx-port 8652
  499. ```
  500. The MCP Configuration for custom jadx port will be as follows for claude:
  501. ```
  502. {
  503. "mcpServers": {
  504. "jadx-mcp-server": {
  505. "command": "/path/to/uv",
  506. "args": [
  507. "--directory",
  508. "/path/to/jadx-mcp-server/",
  509. "run",
  510. "jadx_mcp_server.py",
  511. "--jadx-port",
  512. "8652"
  513. ]
  514. }
  515. }
  516. }
  517. ```
  518. ## Give it a shot
  519. 1. Run jadx-gui and load any .apk file
  520. ![img_1.png](docs/assets/img_1.png)
  521. 2. Start claude - You must see hammer symbol
  522. ![img2.png](docs/assets/img2.png)
  523. 3. Click on the `hammer` symbol and you should you see somthing like following:
  524. ![img3.png](docs/assets/img3.png)
  525. 4. Run following prompt:
  526. ```text
  527. fetch currently selected class and perform quick sast on it
  528. ```
  529. ![img4.png](docs/assets/img4.png)
  530. 5. Allow access when prompted:
  531. ![img_1.png](docs/assets/img5.png)
  532. 6. HACK!
  533. ![img_2.png](docs/assets/img6.png)
  534. This plugin allows total control over the GUI and internal project model to support deeper LLM integration, including:
  535. - Exporting selected class to MCP
  536. - Running automated Claude analysis
  537. - Receiving back suggestions inline
  538. ---
  539. ## Troubleshooting
  540. [Check here](https://github.com/zinja-coder/jadx-ai-mcp/edit/jadx-ai/TROUBLESHOOTING.md)
  541. ## NOTE For Contributors
  542. - The files related to JADX-AI-MCP can be found under this repo.
  543. - The files related to **jadx-mcp-server** can be found [here](https://github.com/zinja-coder/jadx-mcp-server).
  544. ## To report bugs, issues, feature suggestion, Performance issue, general question, Documentation issue.
  545. - Kindly open an issue with respective template.
  546. - Tested on Claude Desktop Client, support for other AI will be tested soon!
  547. ## 🙏 Credits
  548. This project is a plugin for JADX, an amazing open-source Android decompiler created and maintained by [@skylot](https://github.com/skylot). All core decompilation logic belongs to them. I have only extended it to support my MCP server with AI capabilities.
  549. [📎 Original README (JADX)](https://github.com/skylot/jadx)
  550. The original README.md from jadx is included here in this repository for reference and credit.
  551. This MCP server is made possible by the extensibility of JADX-GUI and the amazing Android reverse engineering community.
  552. Also huge thanks to [@aaddrick](https://github.com/aaddrick) for developing Claude desktop for Debian based linux.
  553. And in last thanks to [@anthropics](https://github.com/anthropics) for developing the Model Context Protocol and [@FastMCP](https://github.com/modelcontextprotocol/python-sdk) team
  554. Apart from this, huge thanks to all open source projects which serve as a dependencies for this project and which made this possible.
  555. ### Dependencies
  556. This project uses following awesome libraries.
  557. - Plugin - Java
  558. - Javalin - https://javalin.io/ - Apache 2.0 License
  559. - SLF4J - https://slf4j.org/ - MIT License
  560. - org.w3c.dom - https://mvnrepository.com/artifact/org.w3c.dom - W3C Software and Document License
  561. - MCP Server - Python
  562. - FastMCP - https://github.com/jlowin/fastmcp - Apache 2.0 License
  563. - httpx - https://www.python-httpx.org - BSD-3-Clause (“BSD licensed”)
  564. ## 📄 License
  565. JADX-AI-MCP and all related projects inherits the Apache 2.0 License from the original JADX repository.
  566. ## ⚖️ Legal Warning
  567. **Disclaimer**
  568. The tools `jadx-ai-mcp` and `jadx_mcp_server` are intended strictly for educational, research, and ethical security assessment purposes. They are provided "as-is" without any warranties, expressed or implied. Users are solely responsible for ensuring that their use of these tools complies with all applicable laws, regulations, and ethical guidelines.
  569. By using `jadx-ai-mcp` or `jadx_mcp_server`, you agree to use them only in environments you are authorized to test, such as applications you own or have explicit permission to analyze. Any misuse of these tools for unauthorized reverse engineering, infringement of intellectual property rights, or malicious activity is strictly prohibited.
  570. The developers of `jadx-ai-mcp` and `jadx_mcp_server` shall not be held liable for any damage, data loss, legal consequences, or other consequences resulting from the use or misuse of these tools. Users assume full responsibility for their actions and any impact caused by their usage.
  571. Use responsibly. Respect intellectual property. Follow ethical hacking practices.
  572. ---
  573. ## 🙌 Contribute or Support
  574. - Found it useful? Give it a ⭐️
  575. - Got ideas? Open an [issue](https://github.com/zinja-coder/jadx-ai-mcp/issues) or submit a PR
  576. - Built something on top? DM me or mention me — I’ll add it to the README!
  577. - Do you like my work and keep it going? Sponsor this project.
  578. ---
  579. Built with ❤️ for the reverse engineering and AI communities.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.