Skip to content
Back to search

jadx-mcp-plugin

⚙️ Jadx MCP Plugin — Decompiler Access for Claude via MCP

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/mobilehackinglab--jadx-mcp-plugin/badge.svg)](/listings/mobilehackinglab--jadx-mcp-plugin)

HTML

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

# Clone this repository
git clone https://github.com/mobilehackinglab/jadx-mcp-plugin.git
cd jadx-mcp-plugin

# Create and activate a virtual environment
python3 -m venv venv

# Activate:
source venv/bin/activate      # Linux/Mac
.\venv\Scripts\activate       # Windows

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 · 167 lines

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

  1. ## ⚙️ Jadx MCP Plugin — Decompiler Access for Claude via MCP
  2. This project provides a [Jadx](https://github.com/skylot/jadx) plugin written in **Java**, which exposes the **Jadx API over HTTP** — enabling live interaction through MCP clients like [Claude](https://www.anthropic.com/index/introducing-claude) via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). A lightweight [FastMCP](https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#resources) adapter in Python acts as a bridge between Claude and the plugin. This enables intelligent navigation and automation of reverse engineering workflows, ideal for AI-assisted security analysis of Android apps.
  3. ---
  4. ### 🧰 Setup Instructions
  5. ```bash
  6. # Clone this repository
  7. git clone https://github.com/mobilehackinglab/jadx-mcp-plugin.git
  8. cd jadx-mcp-plugin
  9. # Create and activate a virtual environment
  10. python3 -m venv venv
  11. # Activate:
  12. source venv/bin/activate # Linux/Mac
  13. .\venv\Scripts\activate # Windows
  14. ```
  15. ### Install Python dependencies
  16. ```bash
  17. pip install -r requirements.txt
  18. ```
  19. ### 🧠 Setup Claude MCP CLient Integration
  20. To use this adapter in Claude Desktop, go to `File` -> `Settings` -> `Developer` -> `Edit Config` -> `claude_desktop_config.json` and add an MCP server pointing to the Python executable in the venv (to prevent depedency issues) and the full adapter path following below examples:
  21. Windows:
  22. ```json
  23. {
  24. "mcpServers": {
  25. "Jadx MCP Server": {
  26. "command": "C:\\Workset\\jadx-mcp-plugin\\venv\\Scripts\\python.exe",
  27. "args": ["C:\\Workset\\jadx-mcp-plugin\\fastmcp_adapter.py"]
  28. }
  29. }
  30. }
  31. ```
  32. MacOS / Linux:
  33. ```json
  34. {
  35. "mcpServers": {
  36. "Jadx MCP Server": {
  37. "command": "/Users/yourname/jadx-mcp-plugin/venv/bin/python",
  38. "args": ["/Users/yourname/jadx-mcp-plugin/fastmcp_adapter.py"]
  39. }
  40. }
  41. }
  42. ```
  43. Make sure to restart (Quit) Claude after editing the config.
  44. After restart it should look like this:
  45. ![](img/jadx-mcp-running.png)
  46. ### ✅ Usage Flow
  47. 1. Open **Jadx** with the latest plugin JAR from [the releases](https://github.com/mobilehackinglab/jadx-mcp-plugin/releases) placed in its `plugins/` folder or load it via `Plugins` -> `install plugin`.
  48. 2. Load an APK or DEX file
  49. 3. (Optional) You can specify the HTTP interface address by launching Jadx with:
  50. ```bash
  51. jadx-gui -Pjadx-mcp.http-interface=http://localhost:8085
  52. ```
  53. This is useful if you want to change the default host/port (`http://localhost:8085`).
  54. > **Note:** If you change the interface address here, make sure to also update the corresponding URL in `fastmcp_adapter.py` to match.
  55. 4. Claude will detect and activate the Jadx MCP Server tools.
  56. 5. You can now list classes, fetch source, inspect methods/fields, and extract code live.
  57. ---
  58. ## 🧪 Tools Provided
  59. | Tool | Description |
  60. |-----------------------|---------------------------------------|
  61. | `list_all_classes` | Get all decompiled class names |
  62. | `search_class_by_name` | Find classes matching a string |
  63. | `get_class_source` | Get full source of a given class |
  64. | `search_method_by_name` | Find methods matching a string |
  65. | `get_methods_of_class` | List all method names in a class |
  66. | `get_fields_of_class` | List all field names in a class |
  67. | `get_method_code` | Extract decompiled code for a method |
  68. ---
  69. ## 🛠 Development
  70. ### ☕ Java Plugin
  71. The Java plugin is located at:
  72. ```
  73. plugin/src/main/java/com/mobilehackinglab/jadxplugin/McpPlugin.java
  74. ```
  75. It uses the `JadxPlugin` API (`jadx.api.*`) to:
  76. - Load decompiled classes and methods
  77. - Serve structured data via an embedded HTTP server
  78. - Respond to `/invoke` and `/tools` endpoints
  79. #### 🚀 Automated Installation with Gradle Tasks
  80. You can use the following Gradle task to build and install the plugin in one step:
  81. ```bash
  82. ./gradlew installPlugin
  83. ```
  84. > This uses the `jadx plugins` CLI. Make sure Jadx is installed and available in your `PATH`.
  85. For other plugin-related tasks (uninstall, enable/disable), see the task definitions in [`plugin/build.gradle`](./plugin/build.gradle).
  86. #### 🔧 Manual Installation
  87. To build the plugin:
  88. ```bash
  89. ./gradlew build
  90. # Output: plugin/build/libs/jadx-mcp-plugin-<version>.jar
  91. ```
  92. Install the plugin JAR using the `jadx plugins` CLI:
  93. ```bash
  94. jadx plugins --install-jar path/to/jadx-mcp-plugin-<version>.jar
  95. ```
  96. Alternatively, place the built `.jar` file into your Jadx `plugins/` folder, typically located at: `~/.jadx/plugins/`
  97. If you place the JAR manually, you’ll also need to enable the plugin through the Jadx GUI or by running:
  98. ```bash
  99. jadx plugins --enable jadx-mcp
  100. ```
  101. ---
  102. ### Python FastMCP Adapter
  103. The adapter file is:
  104. ```
  105. fastmcp_adapter.py
  106. ```
  107. It translates Claude’s MCP tool calls into HTTP POSTs to the running Jadx plugin server. Make sure Jadx is open **before** starting Claude.
  108. ---
  109. ## 🤝 Contributing
  110. PRs, feature requests, and tool extensions are welcome!
  111. This project is maintained by [Mobile Hacking Lab](https://github.com/mobilehackinglab).
  112. ---
  113. ## 🧩 Credits
  114. - [Jadx](https://github.com/skylot/jadx)
  115. - [FastMCP](https://github.com/modelcontextprotocol/python-sdk)
  116. - [Claude by Anthropic](https://www.anthropic.com)

Ratings and comments

Sign in to rate this skill.

Sign in

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