Skip to content
Back to search

jadx-mcp-server

MCP server for JADX-AI Plugin

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-mcp-server/badge.svg)](/listings/zinja-coder--jadx-mcp-server)

HTML

<a href="/listings/zinja-coder--jadx-mcp-server"><img src="/api/listings/zinja-coder--jadx-mcp-server/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.

[READ HERE](https://github.com/zinja-coder/jadx-ai-mcp?tab=readme-ov-file#%EF%B8%8F-getting-started)

Demo: **Perform Code Review to Find Vulnerabilities locally**

https://github.com/user-attachments/assets/4cd26715-b5e6-4b4b-95e4-054de6789f42

Advanced CLI Options — Understanding the Flags

There are **two separate connections** and each has its own host/port:

┌─────────────┐    --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         │                  │
└─────────────┘                        └──────────────────┘                               └──────────────────┘

| Flag | Default | Controls | |------|---------|----------| | `--http` | off | Use HTTP transport instead of stdio | | `--host` | `127.0.0.1` | **Where the MCP server listens** (bind address for LLM clients) | | `--port` | `8651` | **Which port the MCP server listens on** | | `--jadx-host` | `127.0.0.1` | **Where to find the JADX plugin** (the target JADX-GUI machine) | | `--jadx-port` | `8650` | **Which port the JADX plugin is on** |

Usage Examples

**Scenario 1 — Everything on the same machine (most common):**

# Default: MCP server on localhost:8651, connects to JADX plugin on localhost:8650
uv run jadx_mcp_server.py --http

**Scenario 2 — Docker container or WSL (MCP server accessible from host network):**

# 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

**Scenario 3 — JADX-GUI running on a different machine (e.g., remote VM):**

# 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

**Scenario 4 — Full remote setup (everything on different machines):**

# 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

> [!CAUTION] > ### ⚠️ Security Warning — Remote Binding > > 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: > > - **Anyone on the network** can connect and invoke all MCP tools > - There is **no TLS encryption** — traffic can be intercepted > - An attacker can use the server to **read decompiled code**, **rename classes/methods**, and **access debug info** > > **Mitigations:** > - Only bind to `0.0.0.0` on **trusted, isolated networks** (e.g., Docker bridge, local VM) > - Use a **firewall** to restrict access to the MCP port > - Consider an **SSH tunnel** instead: `ssh -L 8651:127.0.0.1:8651 remote-host` > > Similarly, `--jadx-host` with a non-localhost address means the MCP server will make **unauthenticated HTTP requests** to that host. Ensure the target is trusted.

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 · 535 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-MCP-SERVER (Part of Zin's Reverse Engineering MCP Suite)
  3. ⚡ Fully automated MCP server built to communicate with JADX-AI-MCP Plugin to analyze Android APKs using LLMs like Claude — uncover vulnerabilities, parse manifests, 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/badmonkey7">
  24. <img src="https://avatars.githubusercontent.com/u/41368882?v=4" width="30px;" alt=""/>
  25. <br /><sub><b>badmonkey7</b></sub>
  26. </a>
  27. </td>
  28. <td>
  29. <a href="https://github.com/p0px">
  30. <img src="https://avatars.githubusercontent.com/u/161268024?v=4" width="30px;" alt=""/>
  31. <br /><sub><b>p0px</b></sub>
  32. </a>
  33. </td>
  34. <td>
  35. <a href="https://github.com/bx33661">
  36. <img src="https://avatars.githubusercontent.com/u/138348615?v=4" width="30px;" alt=""/>
  37. <br /><sub><b>bx33661</b></sub>
  38. </a>
  39. </td>
  40. <td>
  41. <a href="https://github.com/Haicaji">
  42. <img src="https://avatars.githubusercontent.com/u/132796021?v=4" width="30px;" alt=""/>
  43. <br /><sub><b>Haicaji</b></sub>
  44. </a>
  45. </td>
  46. <td>
  47. <a href="https://github.com/mostafaNazari702">
  48. <img src="https://avatars.githubusercontent.com/u/93077724?v=4" width="30px;" alt=""/>
  49. <br /><sub><b>Mostafa Nazari</b></sub>
  50. </a>
  51. </td>
  52. <td>
  53. <a href="https://github.com/ChineseAStar">
  54. <img src="https://avatars.githubusercontent.com/u/24355243?v=4" width="30px;" alt=""/>
  55. <br /><sub><b>ChineseAStar</b></sub>
  56. </a>
  57. </td>
  58. <td>
  59. <a href="https://github.com/cyal1r">
  60. <img src="https://avatars.githubusercontent.com/u/33282478?v=4" width="30px;" alt=""/>
  61. <br /><sub><b>cyal1</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>tainn</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. <!-- Still in early stage of development — expect bugs, crashes, and logical errors.-->
  160. <!-- MCP (Model Context Protocol) server that connects to a custom plugin of [JADX](https://github.com/skylot/jadx) called [JADX-AI-MCP](https://github.com/zinja-coder/jadx-ai-mcp) and provides reverse engineering capabilities directly to local LLMs like Claude Desktop.-->
  161. <div align="center">
  162. <img alt="banner" height="480px" widht="620px" src="static/image.png">
  163. </div>
  164. #### ReadTheDocs:
  165. - We are now live at Read The Docs:
  166. ---
  167. #### Download now: https://github.com/zinja-coder/jadx-ai-mcp/releases
  168. ---
  169. ## 🤖 What is JADX-MCP-SERVER?
  170. **JADX MCP Server** is a standalone Python server that interacts with a modified version of `jadx-gui` (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.
  171. ## 🤖 What is JADX-AI-MCP?
  172. **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**.
  173. Think: "Decompile → Context-Aware Code Review → AI Recommendations" — all in real time.
  174. #### High Level Sequence Diagram
  175. ```mermaid
  176. sequenceDiagram
  177. LLM CLIENT->>JADX MCP SERVER: INVOKE MCP TOOL
  178. JADX MCP SERVER->>JADX AI MCP PLUGIN: INVOKE HTTP REQUEST
  179. JADX AI MCP PLUGIN->>REQUEST HANDLERS: INVOKE HTTP REQUEST HANDLER
  180. REQUEST HANDLERS->>JADX GUI: PERFORM ACTION/GATHER DATA
  181. JADX GUI->>REQUEST HANDLERS: ACTION PERFORMED/DATA GATHERED
  182. REQUEST HANDLERS->>JADX AI MCP PLUGIN: CRAFT HTTP RESPONSE
  183. JADX AI MCP PLUGIN->>JADX MCP SERVER:HTTP RESPONSE
  184. JADX MCP SERVER->>LLM CLIENT: MCP TOOL RESULT
  185. ```
  186. Watch the demos!
  187. - **Perform quick analysis**
  188. https://github.com/user-attachments/assets/b65c3041-fde3-4803-8d99-45ca77dbe30a
  189. - **Quickly find vulnerabilities**
  190. https://github.com/user-attachments/assets/c184afae-3713-4bc0-a1d0-546c1f4eb57f
  191. - **Multiple AI Agents Support**
  192. https://github.com/user-attachments/assets/6342ea0f-fa8f-44e6-9b3a-4ceb8919a5b0
  193. - **Analyze The APK Resources**
  194. https://github.com/user-attachments/assets/f42d8072-0e3e-4f03-93ea-121af4e66eb1
  195. - **Your AI Assistant during debugging of APK using JADX**
  196. https://github.com/user-attachments/assets/2b0bd9b1-95c1-4f32-9b0c-38b864dd6aec
  197. It is combination of two tools:
  198. 1. [JADX-AI-MCP](https://github.com/zinja-coder/jadx-ai-mcp)
  199. 2. JADX MCP SERVER
  200. ---
  201. # Zin MCP Suite
  202. - **[APKTool-MCP-Server](https://github.com/zinja-coder/apktool-mcp-server)**
  203. - **[JAD-AI-MCP-Plugin](https://github.com/zinja-coder/jadx-ai-mcp)**
  204. - **[ZIN-MCP-Client](https://github.com/zinja-coder/zin-mcp-client)**
  205. ## Current MCP Tools
  206. The following MCP tools are available:
  207. Tools that return decompiled source strip Kotlin compiler metadata (`@Metadata` /
  208. `@DebugMetadata`, often 25-50% of a Kotlin dump) by default; pass `slim=False` for a
  209. raw dump. Stripping never changes line numbers, so `with_line_numbers=True` and
  210. `add_comment(line=...)` keep working.
  211. - `fetch_current_class(slim=True)` — Get the class name and full source of selected class
  212. - `get_selected_text()` — Get currently selected text
  213. - `get_all_classes()` — List all classes in the project
  214. - `get_class_source(slim=True)` — Get full source of a given class (`with_line_numbers=True` to number the lines for `add_comment(line=...)`)
  215. - `get_method_by_name(slim=True)` — Fetch a method’s source
  216. - `search_method_by_name()` — Search method across classes
  217. - `search_classes_by_keyword()` — Search for classes whose source code contains a specific keyword (supports pagination)
  218. - `get_methods_of_class()` — List methods in a class
  219. - `get_fields_of_class()` — List fields in a class
  220. - `get_smali_of_class()` — Fetch smali of class
  221. - `get_main_activity_class(slim=True)` — Fetch main activity from jadx mentioned in AndroidManifest.xml file.
  222. - `get_main_application_classes_code(slim=True)` — Fetch all the main application classes' code based on the package name defined in the AndroidManifest.xml.
  223. - `get_main_application_classes_names()` — Fetch all the main application classes' names based on the package name defined in the AndroidManifest.xml.
  224. - `get_android_manifest()` — Retrieve and return the AndroidManifest.xml content.
  225. - `get_manifest_component` - Retrieve specific manifest component instead of whole manifest file
  226. - `get_strings()` : Fetches the strings.xml file
  227. - `get_all_resource_file_names()` : Retrieve all resource files names that exists in application
  228. - `get_resource_file()` : Retrieve resource file content
  229. - `rename_variable()` : Renames the variable within a method
  230. - `add_comment()` : Adds a comment to a class, method, field or a single code line (`line=`), shown in JADX-GUI and saved with the project (re-commenting the same target updates it, an empty comment removes it)
  231. - `list_comments()` : Lists the comments stored in the project, optionally filtered to one class
  232. - `debug_get_stack_frames()` : Get the stack frames from jadx debugger
  233. - `debug_get_threads()` : Get the insights of threads from jadx debugger
  234. - `debug_get_variables()` : Get the variables from jadx debugger
  235. - `xrefs_to_class()` : Find all references to a class (returns method-level and class-level references, supports pagination)
  236. - `xrefs_to_method()` : Find all references to a method (includes override-related methods, supports pagination)
  237. - `xrefs_to_field()` : Find all references to a field (returns methods that access the field, supports pagination)
  238. ---
  239. #### Note: Tested on Claude Desktop. Support for other LLMs might be tested in future.
  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. 📦 Static Analysis
  256. "List all network-related API calls in this class."
  257. "Identify file I/O operations and their potential risks."
  258. "Does this method leak device info or PII?"
  259. 🤖 AI Code Modification
  260. "Refactor this method to improve readability."
  261. "Add comments to this code explaining each step."
  262. "Rewrite this Java method in Python for analysis."
  263. 📄 Documentation & Metadata
  264. "Generate Javadoc-style comments for all methods."
  265. "What package or app component does this class likely belong to?"
  266. "Can you identify the Android component type (Activity, Service, etc.)?"
  267. 🐞 Debugger Assistant
  268. ```
  269. "Fetch stack frames, varirables and threads from debugger and provide summary"
  270. "Based the stack frames from debugger, explain the execution flow of the application"
  271. "Based on the state of variables, is there security threat?"
  272. ```
  273. ---
  274. ## 🛠️ Getting Started
  275. [READ HERE](https://github.com/zinja-coder/jadx-ai-mcp?tab=readme-ov-file#%EF%B8%8F-getting-started)
  276. Demo: **Perform Code Review to Find Vulnerabilities locally**
  277. https://github.com/user-attachments/assets/4cd26715-b5e6-4b4b-95e4-054de6789f42
  278. ### Advanced CLI Options — Understanding the Flags
  279. There are **two separate connections** and each has its own host/port:
  280. ```
  281. ┌─────────────┐ --host / --port ┌──────────────────┐ --jadx-host / --jadx-port ┌──────────────────┐
  282. │ LLM Client │ ◄──────────────────► │ jadx-mcp-server │ ──────────────────────────► │ JADX-GUI Plugin │
  283. │ (Claude, │ Where the MCP server │ │ Where the MCP server looks │ (jadx-ai-mcp) │
  284. │ Codex..) │ LISTENS for clients │ │ for the JADX plugin │ │
  285. └─────────────┘ └──────────────────┘ └──────────────────┘
  286. ```
  287. | Flag | Default | Controls |
  288. |------|---------|----------|
  289. | `--http` | off | Use HTTP transport instead of stdio |
  290. | `--host` | `127.0.0.1` | **Where the MCP server listens** (bind address for LLM clients) |
  291. | `--port` | `8651` | **Which port the MCP server listens on** |
  292. | `--jadx-host` | `127.0.0.1` | **Where to find the JADX plugin** (the target JADX-GUI machine) |
  293. | `--jadx-port` | `8650` | **Which port the JADX plugin is on** |
  294. ### Usage Examples
  295. **Scenario 1 — Everything on the same machine (most common):**
  296. ```bash
  297. # Default: MCP server on localhost:8651, connects to JADX plugin on localhost:8650
  298. uv run jadx_mcp_server.py --http
  299. ```
  300. **Scenario 2 — Docker container or WSL (MCP server accessible from host network):**
  301. ```bash
  302. # MCP server listens on ALL interfaces so the host can reach it
  303. # JADX plugin is still on the same machine
  304. uv run jadx_mcp_server.py --http --host 0.0.0.0
  305. ```
  306. **Scenario 3 — JADX-GUI running on a different machine (e.g., remote VM):**
  307. ```bash
  308. # MCP server runs locally, but connects to JADX plugin on a remote machine
  309. uv run jadx_mcp_server.py --http --jadx-host 192.168.1.100
  310. ```
  311. **Scenario 4 — Full remote setup (everything on different machines):**
  312. ```bash
  313. # MCP server listens on all interfaces on port 9999
  314. # JADX plugin is on a different machine at 192.168.1.100:8652
  315. uv run jadx_mcp_server.py --http --host 0.0.0.0 --port 9999 --jadx-host 192.168.1.100 --jadx-port 8652
  316. ```
  317. > [!CAUTION]
  318. > ### ⚠️ Security Warning — Remote Binding
  319. >
  320. > 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:
  321. >
  322. > - **Anyone on the network** can connect and invoke all MCP tools
  323. > - There is **no TLS encryption** — traffic can be intercepted
  324. > - An attacker can use the server to **read decompiled code**, **rename classes/methods**, and **access debug info**
  325. >
  326. > **Mitigations:**
  327. > - Only bind to `0.0.0.0` on **trusted, isolated networks** (e.g., Docker bridge, local VM)
  328. > - Use a **firewall** to restrict access to the MCP port
  329. > - Consider an **SSH tunnel** instead: `ssh -L 8651:127.0.0.1:8651 remote-host`
  330. >
  331. > Similarly, `--jadx-host` with a non-localhost address means the MCP server will make **unauthenticated HTTP requests** to that host. Ensure the target is trusted.
  332. ### Driving the server from any OpenAI-compatible model
  333. MCP-aware apps connect directly. For everything else that speaks `POST /v1/chat/completions` —
  334. OpenRouter, LiteLLM, vLLM, Ollama's OpenAI layer, OmniRoute, … — `examples/openai_compatible_client.py`
  335. is a reference adapter: it connects to a running `jadx_mcp_server.py --http`, converts the MCP tool list
  336. into OpenAI function-calling tools, and runs the call → execute → feed-back loop until the model answers.
  337. ```bash
  338. # terminal 1
  339. uv run jadx_mcp_server.py --http --host 127.0.0.1 --port 9000
  340. # the example needs the openai SDK; the server itself does not
  341. pip install -r examples/requirements.txt
  342. # OpenAI
  343. OPENAI_API_KEY=sk-... python examples/openai_compatible_client.py \
  344. --prompt "What does com.example.app.MainActivity do?"
  345. # a local gateway (any placeholder key works)
  346. OPENAI_BASE_URL=http://127.0.0.1:11434/v1 OPENAI_API_KEY=ollama OPENAI_MODEL=llama3.1 \
  347. python examples/openai_compatible_client.py
  348. # show the tool schema the model is offered, without calling a model at all
  349. python examples/openai_compatible_client.py --list-tools
  350. ```
  351. `--base-url`, `--api-key` and `--model` (or the `OPENAI_BASE_URL` / `OPENAI_API_KEY` / `OPENAI_MODEL`
  352. environment variables) point it at any provider. `--max-steps` caps how many tool rounds a question may
  353. take and `--max-tool-chars` truncates a single result, so one large class dump cannot blow the model's
  354. context. Run it without `--prompt` for an interactive session.
  355. ## 🛣️ Future Roadmap
  356. - [x] Add Support for apktool
  357. - [ ] Add support for hermes code (ReactNative Application)
  358. - [ ] Add docker support
  359. - [x] Add more useful MCP Tools
  360. - [x] Make LLM be able to modify code on JADX
  361. - [x] Add prompts templates, give llm access to Android APK Files as Resources
  362. - [ ] ~~Build MCP Client to support Local LLM~~
  363. - [ ] **END-GOAL** : Make all android reverse engineering and APK modification tools Connect with single MCP server to make reverse engineering apk files as easy as possible purely from vibes.
  364. ## NOTE For Contributors
  365. - The files related to JADX-AI-MCP can be found [here](https://github.com/zinja-coder/jadx-ai-mcp)
  366. - The files related to **jadx-mcp-server** can be found in this repository only.
  367. ## 🙏 Credits
  368. 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.
  369. [📎 Original README (JADX)](https://github.com/skylot/jadx)
  370. The original README.md from jadx is included here in this repository for reference and credit.
  371. This MCP server is made possible by the extensibility of JADX-GUI and the amazing Android reverse engineering community.
  372. Also huge thanks to [@aaddrick](https://github.com/aaddrick) for developing Claude desktop for Debian based linux.
  373. 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
  374. And all open source maintainers and contributors that makes libraries and dependencies which allows project like this possible.
  375. ## Audited and Received Assessment Badge
  376. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/zinja-coder-jadx-mcp-server-badge.png)](https://mseep.ai/app/zinja-coder-jadx-mcp-server)
  377. Thank you Mseep.net for auditing and providing Assessment Badge.
  378. ### Dependencies
  379. This project uses following awesome libraries.
  380. - Plugin - Java
  381. - Javalin - https://javalin.io/ - Apache 2.0 License
  382. - SLF4J - https://slf4j.org/ - MIT License
  383. - org.w3c.dom - https://mvnrepository.com/artifact/org.w3c.dom - W3C Software and Document License
  384. - MCP Server - Python
  385. - FastMCP - https://github.com/jlowin/fastmcp - Apache 2.0 License
  386. - httpx - https://www.python-httpx.org - BSD-3-Clause (“BSD licensed”)
  387. ## 📄 License
  388. This plugin inherits the Apache 2.0 License from the original JADX repository.
  389. ## ⚖️ Legal Warning
  390. **Disclaimer**
  391. 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.
  392. 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.
  393. 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.
  394. Use responsibly. Respect intellectual property. Follow ethical hacking practices.
  395. ---
  396. ## 🙌 Contribute or Support
  397. - Found it useful? Give it a ⭐️
  398. - Got ideas? Open an [issue](https://github.com/zinja-coder/jadx-mcp-server/issues) or submit a PR
  399. - Built something on top? DM me or mention me — I’ll add it to the README!
  400. ---
  401. 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.