### Смотрите демо!

- **Выполните быстрый анализ**

https://github.com/user-attachments/assets/b65c3041-fde3-4803-8d99-45ca77dbe30a

- **Быстро находите уязвимости**

https://github.com/user-attachments/assets/c184afae-3713-4bc0-a1d0-546c1f4eb57f

- **Поддержка нескольких ИИ-агентов**

https://github.com/user-attachments/assets/6342ea0f-fa8f-44e6-9b3a-4ceb8919a5b0

- **Запускайте со своим любимым LLM-клиентом**

https://github.com/user-attachments/assets/b4a6b280-5aa9-4e76-ac72-a0abec73b809

- **Анализируйте ресурсы APK**

https://github.com/user-attachments/assets/f42d8072-0e3e-4f03-93ea-121af4e66eb1

- **Ваш ИИ-ассистент при отладке APK с помощью JADX**

https://github.com/user-attachments/assets/2b0bd9b1-95c1-4f32-9b0c-38b864dd6aec

Это комбинация двух инструментов:
1. JADX-AI-MCP
2. [JADX MCP SERVER](https://github.com/zinja-coder/jadx-mcp-server)

## 🤖 Что такое JADX-MCP-SERVER?

**JADX MCP Server** — это автономный Python-сервер, который взаимодействует с плагином `JADX-AI-MCP` (см.: [jadx-ai-mcp](https://github.com/zinja-coder/jadx-ai-mcp)) через MCP (Model Context Protocol). Он позволяет LLM взаимодействовать с декомпилированным контекстом Android-приложения в реальном времени.

---

## Другие проекты в составе Zin MCP Suite
 - **[APKTool-MCP-Server](https://github.com/zinja-coder/apktool-mcp-server)**
 - **[JADX-MCP-Server](https://github.com/zinja-coder/jadx-mcp-server)**
 - **[ZIN-MCP-Client](https://github.com/zinja-coder/zin-mcp-client)**

## Текущие MCP-инструменты

Доступны следующие MCP-инструменты:

- `fetch_current_class()` — получить имя класса и полный исходный код выбранного класса
- `get_selected_text()` — получить текущий выделенный текст
- `get_all_classes()` — перечислить все классы в проекте
- `get_class_source()` — получить полный исходный код указанного класса
- `get_method_by_name()` — получить исходный код метода по имени
- `search_method_by_name()` — искать метод по классам
- `search_classes_by_keyword()` — искать классы, исходный код которых содержит определённое ключевое слово (поддерживается постраничная навигация)
- `get_methods_of_class()` — перечислить методы класса
- `get_fields_of_class()` — перечислить поля класса
- `get_smali_of_class()` — получить smali-код класса
- `get_main_activity_class()` — получить главную activity из jadx, указанную в файле AndroidManifest.xml.
- `get_main_application_classes_code()` — получить код всех основных классов приложения на основе имени пакета, определённого в AndroidManifest.xml.
- `get_main_application_classes_names()` — получить имена всех основных классов приложения на основе имени пакета, определённого в AndroidManifest.xml.
- `get_android_manifest()` — извлечь и вернуть содержимое AndroidManifest.xml.
- `get_manifest_component` - извлечь конкретный компонент манифеста вместо всего файла манифеста
- `get_strings()` : получает файл strings.xml
- `get_all_resource_file_names()` : получить имена всех файлов ресурсов, существующих в приложении
- `get_resource_file()` : получить содержимое файла ресурсов
- `rename_class()` : переименовывает класс
- `rename_method()` : переименовывает метод
- `rename_field()` : переименовывает поле
- `rename_package()` : переименовывает весь пакет
- `rename_variable()` : переименовывает переменную внутри метода
- `debug_get_stack_frames()` : получить стек-фреймы из отладчика jadx
- `debug_get_threads()` : получить информацию о потоках из отладчика jadx
- `debug_get_variables()` : получить переменные из отладчика jadx
- `xrefs_to_class()` : найти все ссылки на класс (возвращает ссылки на уровне методов и классов, поддерживается постраничная навигация)
- `xrefs_to_method()` : найти все ссылки на метод (включая методы, связанные с переопределением, поддерживается постраничная навигация)
- `xrefs_to_field()` : найти все ссылки на поле (возвращает методы, обращающиеся к полю, поддерживается постраничная навигация)
  
---

## 🗒️ Примеры запросов

🔍 Базовое понимание кода

    "Объясни, что делает этот класс, в одном абзаце."

    "Обобщи обязанности этого метода."

    "Есть ли в этом классе какая-либо обфускация?"

    "Перечисли все разрешения Android, которые могут потребоваться этому классу."

🛡️ Обнаружение уязвимостей

    "Есть ли в этом методе небезопасные использования API?"

    "Проверь этот класс на наличие захардкоженных секретов или учётных данных."

    "Проводит ли этот метод санитизацию пользовательского ввода перед его использованием?"

    "Какие уязвимости безопасности может внести этот код?"

🛠️ Помощники по обратной разработке

    "Деобфусцируй и переименуй классы и методы в читаемые названия."

    "Можешь предположить изначальное назначение этого smali-метода?"

    "Частью каких библиотек или SDK выглядит этот класс?"

    "Скажи, какие классы содержат код, связанный с 'encryption'?"

📦 Статический анализ

    "Перечисли все сетевые вызовы API в этом классе."

    "Определи операции файлового ввода/вывода и их потенциальные риски."

    "Утекает ли этот метод информация об устройстве или PII?"

🤖 Модификация кода с помощью ИИ

    "Рефактори этот метод, чтобы улучшить читаемость."

    "Добавь комментарии к этому коду, объясняющие каждый шаг."

    "Перепиши этот Java-метод на Python для анализа."

📄 Документация и метаданные

    "Сгенерируй Javadoc-комментарии для всех методов."

    "К какому пакету или компоненту приложения, вероятнее всего, относится этот класс?"

    "Можешь определить тип компонента Android (Activity, Service и т. д.)?"

🐞 Ассистент отладчика```
   "Fetch stack frames, varirables and threads from debugger and provide summary"

   "Based the stack frames from debugger, explain the execution flow of the application"

   "Based on the state of variables, is there security threat?"

<div align="center">
    <img alt="banner" height="480px" widht="620px" src="https://assets.kitploit.com/production/public/readmes/6657/1c2660639daf7352d2bdeafeb7b5e0846e3c0bed45846ee52256b7bf3d316386.png">
</div>

<div align="center">
    <img alt="banner" height="480px" widht="620px" src="https://assets.kitploit.com/production/public/readmes/6657/ccc2cc3566566517abad1097711afad3c668a999dc105d82686c4ffb791eba3b.png">
</div>

<div align="center">
    <img alt="banner" height="480px" widht="620px" src="https://assets.kitploit.com/production/public/readmes/6657/0f9770bc38f4234826a661e6d37bc205a801ad38380363fd4394a903bd35ff94.png">
</div>```bash
## 3. GUI method, download the .jar file and follow below steps shown in images

## a. Install uv (if you dont have it yet)

## 🤖 2. Использование Claude Desktop

Убедитесь, что Claude Desktop запущен с включённым MCP.

Например, я использовал следующее для Kali Linux: https://github.com/aaddrick/claude-desktop-debian

Настройте и добавьте MCP-сервер в файл LLM:```bash
nano ~/.config/Claude/claude_desktop_config.json

Замените:

- `path/to/uv` на фактический путь к вашему исполняемому файлу `uv`
- `path/to/jadx-mcp-server` на абсолютный путь к месту, куда вы клонировали этот
репозиторий

Затем перемещайтесь по коду и взаимодействуйте через запросы на ревью кода в реальном времени с помощью встроенной интеграции.

**ИЛИ**

или вы можете установить jadx_mcp_server напрямую как исполняемый файл, используя приведённую ниже команду:```
uv tool install git+https://github.com/zinja-coder/jadx-mcp-server

- `path/to/jadx-mcp-server` с абсолютным путём к месту, куда вы склонировали этот
репозиторий

## 4. Использование LMStudio

Вы также можете использовать JADX AI MCP Server с LM Studio, настроив его файл mcp.json. Вот видеоинструкция.

https://github.com/user-attachments/assets/b4a6b280-5aa9-4e76-ac72-a0abec73b809

## 5. Запуск в режиме HTTP Stream

Вы также можете использовать Jadx в режиме HTTP Stream с помощью опции `--http` с `jadx_mcp_server.py`, как показано ниже:```bash
uv run jadx_mcp_server.py --http

OR

uv run jadx_mcp_server.py --http --port 9999

| Flag | По умолчанию | Управляет |
|------|---------|----------|
| `--http` | off | Использовать HTTP-транспорт вместо stdio |
| `--host` | `127.0.0.1` | **Где прослушивает MCP-сервер** (адрес привязки для LLM-клиентов) |
| `--port` | `8651` | **На каком порту прослушивает MCP-сервер** |
| `--jadx-host` | `127.0.0.1` | **Где найти плагин JADX** (целевая машина JADX-GUI) |
| `--jadx-port` | `8650` | **На каком порту работает плагин JADX** |

### Примеры использования

**Сценарий 1 — Всё на одной машине (самый распространённый):**```bash
# Default: MCP server on localhost:8651, connects to JADX plugin on localhost:8650
uv run jadx_mcp_server.py --http

**Сценарий 3 — JADX-GUI, запущенный на другой машине (например, на удалённой виртуальной машине):**```bash
# 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

> [!CAUTION]
> ### ⚠️ Предупреждение безопасности — удалённая привязка
>
> При использовании `--host 0.0.0.0` (или любого адреса, кроме localhost) сервер MCP привязывается ко **всем сетевым интерфейсам** через **обычный HTTP без аутентификации**. Это означает:
>
> - **Любой в сети** может подключиться и вызывать все инструменты MCP
> - **Нет TLS-шифрования** — трафик может быть перехвачен
> - Злоумышленник может использовать сервер для **чтения декомпилированного кода**, **переименования классов/методов** и **доступа к отладочной информации**
>
> **Меры предосторожности:**
> - Привязывайте `0.0.0.0` только в **доверенных изолированных сетях** (например, мост Docker, локальная ВМ)
> - Используйте **брандмауэр** для ограничения доступа к порту MCP
> - Вместо этого рассмотрите **SSH-туннель**: `ssh -L 8651:127.0.0.1:8651 remote-host`

### Совместимость со stdio-режимом

> [!NOTE]
> При работе в режиме **stdio** (по умолчанию, без `--http`) весь человекочитаемый вывод (баннер, проверка состояния) записывается в **stderr**, чтобы **stdout** оставался зарезервированным для потока MCP JSON-RPC. Это обеспечивает совместимость с Codex, Claude Desktop и другими stdio-клиентами MCP.

## 6. Настройка пользовательского порта и хоста для JADX AI MCP Plugin

<img width="800" height="335" alt="image" src="https://assets.kitploit.com/production/public/readmes/6657/34e13964afba1fa722733838892491b2ec9ea2d11f2dfd4e8612aa62817dfa41.png" />

1. Настройка порта: Укажите порт, который будет прослушивать JADX AI MCP Plugin.
2. Порт по умолчанию: Отмените изменения и прослушивайте порт по умолчанию.
3. Перезапуск сервера: Принудительно перезапустите сервер JADX AI MCP Plugin.
4. Статус сервера: Проверьте статус сервера JADX AI MCP Plugin.

Для подключения к JADX AI MCP Plugin, работающему на пользовательском порту, используется опция `--jadx-port`, как показано ниже:```
uv run jadx_mcp_server.py --jadx-port 8652

### Справочник по CLI — Понимание флагов

Существует **два отдельных соединения**, и у каждого есть свой хост/порт:```
┌─────────────┐    --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         │                  │
└─────────────┘                        └──────────────────┘                               └──────────────────┘

**Сценарий 2 — контейнер Docker или WSL (MCP-сервер доступен из сети хоста):**```bash
# 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

**Сценарий 4 — Полностью удалённая настройка (всё на разных машинах):**```bash
# 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

## Попробуйте

1. Запустите jadx-gui и загрузите любой .apk файл

![img_1.png](https://assets.kitploit.com/production/public/readmes/6657/57512ca023da5fdca0cc3fac791a68e1c76c9ff4e97d9391ca6fdcf8b6e34bff.png)

2. Запустите claude — вы должны увидеть значок молотка

![img2.png](https://assets.kitploit.com/production/public/readmes/6657/18d5936ea3d66f3667e827f2b757926f56230f5b0a150eb0077414cca550009e.png)

3. Нажмите на значок `молотка`, и вы должны увидеть что-то вроде следующего:

![img3.png](https://assets.kitploit.com/production/public/readmes/6657/ce4c8a048d32bb1f5a16fed73153b83ec78c3253a0109fb7aa064f064b34fc34.png)

4. Выполните следующий промпт:```text
fetch currently selected class and perform quick sast on it