Back to search
jadx-mcp-plugin
MCP serverGitHub
⚙️ 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
Markdown
[](/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)
- ## ⚙️ Jadx MCP Plugin — Decompiler Access for Claude via MCP
- 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.
- ---
- ### 🧰 Setup Instructions
- ```bash
- # 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
- ```
- ### Install Python dependencies
- ```bash
- pip install -r requirements.txt
- ```
- ### 🧠 Setup Claude MCP CLient Integration
- 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:
- Windows:
- ```json
- {
- "mcpServers": {
- "Jadx MCP Server": {
- "command": "C:\\Workset\\jadx-mcp-plugin\\venv\\Scripts\\python.exe",
- "args": ["C:\\Workset\\jadx-mcp-plugin\\fastmcp_adapter.py"]
- }
- }
- }
- ```
- MacOS / Linux:
- ```json
- {
- "mcpServers": {
- "Jadx MCP Server": {
- "command": "/Users/yourname/jadx-mcp-plugin/venv/bin/python",
- "args": ["/Users/yourname/jadx-mcp-plugin/fastmcp_adapter.py"]
- }
- }
- }
- ```
- Make sure to restart (Quit) Claude after editing the config.
- After restart it should look like this:
- 
- ### ✅ Usage Flow
- 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`.
- 2. Load an APK or DEX file
- 3. (Optional) You can specify the HTTP interface address by launching Jadx with:
- ```bash
- jadx-gui -Pjadx-mcp.http-interface=http://localhost:8085
- ```
- This is useful if you want to change the default host/port (`http://localhost:8085`).
- > **Note:** If you change the interface address here, make sure to also update the corresponding URL in `fastmcp_adapter.py` to match.
- 4. Claude will detect and activate the Jadx MCP Server tools.
- 5. You can now list classes, fetch source, inspect methods/fields, and extract code live.
- ---
- ## 🧪 Tools Provided
- | Tool | Description |
- |-----------------------|---------------------------------------|
- | `list_all_classes` | Get all decompiled class names |
- | `search_class_by_name` | Find classes matching a string |
- | `get_class_source` | Get full source of a given class |
- | `search_method_by_name` | Find methods matching a string |
- | `get_methods_of_class` | List all method names in a class |
- | `get_fields_of_class` | List all field names in a class |
- | `get_method_code` | Extract decompiled code for a method |
- ---
- ## 🛠 Development
- ### ☕ Java Plugin
- The Java plugin is located at:
- ```
- plugin/src/main/java/com/mobilehackinglab/jadxplugin/McpPlugin.java
- ```
- It uses the `JadxPlugin` API (`jadx.api.*`) to:
- - Load decompiled classes and methods
- - Serve structured data via an embedded HTTP server
- - Respond to `/invoke` and `/tools` endpoints
- #### 🚀 Automated Installation with Gradle Tasks
- You can use the following Gradle task to build and install the plugin in one step:
- ```bash
- ./gradlew installPlugin
- ```
- > This uses the `jadx plugins` CLI. Make sure Jadx is installed and available in your `PATH`.
- For other plugin-related tasks (uninstall, enable/disable), see the task definitions in [`plugin/build.gradle`](./plugin/build.gradle).
- #### 🔧 Manual Installation
- To build the plugin:
- ```bash
- ./gradlew build
- # Output: plugin/build/libs/jadx-mcp-plugin-<version>.jar
- ```
- Install the plugin JAR using the `jadx plugins` CLI:
- ```bash
- jadx plugins --install-jar path/to/jadx-mcp-plugin-<version>.jar
- ```
- Alternatively, place the built `.jar` file into your Jadx `plugins/` folder, typically located at: `~/.jadx/plugins/`
- If you place the JAR manually, you’ll also need to enable the plugin through the Jadx GUI or by running:
- ```bash
- jadx plugins --enable jadx-mcp
- ```
- ---
- ### Python FastMCP Adapter
- The adapter file is:
- ```
- fastmcp_adapter.py
- ```
- It translates Claude’s MCP tool calls into HTTP POSTs to the running Jadx plugin server. Make sure Jadx is open **before** starting Claude.
- ---
- ## 🤝 Contributing
- PRs, feature requests, and tool extensions are welcome!
- This project is maintained by [Mobile Hacking Lab](https://github.com/mobilehackinglab).
- ---
- ## 🧩 Credits
- - [Jadx](https://github.com/skylot/jadx)
- - [FastMCP](https://github.com/modelcontextprotocol/python-sdk)
- - [Claude by Anthropic](https://www.anthropic.com)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.