mobilehackinglab/jadx-mcp-plugin

⚙️ Jadx MCP Plugin — доступ к декомпилятору Claude через MCP

Этот проект предоставляет плагин Jadx, написанный на Java, который открывает Jadx API через HTTP — обеспечивая реальное взаимодействие через MCP-клиенты, такие как Claude, через протокол Model Context Protocol (MCP). Лёгкий адаптер FastMCP на Python служит мостом между Claude и плагином. Это обеспечивает интеллектуальную навигацию и автоматизацию процессов обратного инжиниринга, что идеально подходит для анализа безопасности Android приложений с помощью искусственного интеллекта.

---

🧰 Инструкции по настройке

Установка зависимостей Python

🧠 Setup Claude MCP CLient Integration

Чтобы использовать этот адаптер в Claude Desktop, перейдите по File -> Settings -> Developer -> Edit Config -> claude_desktop_config.json и добавьте MCP-сервер, указывающий на исполняемый файл Python в venv (чтобы избежать проблем с depedency), а также полный путь адаптера, следующий из следующих примеров:

Окна:

MacOS / Linux:

Обязательно перезагрузите (Выйти) Claude после редактирования конфигурации. После перезапуска он должен выглядеть так:

✅ Поток использования

1. Откройте Jadx с последним плагином JAR из релизов, размещённым в папке plugins/, или загрузите его через Plugins -> install plugin.
2. Загрузите файл APK или DEX

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

This project provides a Jadx plugin written in Java, which exposes the Jadx API over HTTP — enabling live interaction through MCP clients like Claude via the Model Context Protocol (MCP). A lightweight FastMCP 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

# 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

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:

{
  "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:

{
  "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 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:

   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