# zinja-coder/jadx-mcp-server architecture

> Architecture diagram of the GitHub repository zinja-coder/jadx-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zinja-coder/jadx-mcp-server
- Repository: https://github.com/zinja-coder/jadx-mcp-server

## Overview

JADX MCP Server exposes Android reverse-engineering tools to an MCP client, forwarding requests to the JADX plugin and returning live APK context. The principal workflow is client tool invocation → server dispatch → analysis request to JADX → tool result. Distinct capabilities include class inspection, code search, resource and manifest analysis, cross-reference lookup, refactoring, comments, and debugging. Pagination supports large class, resource, search, and reference results. The README documents the plugin-to-JADX-GUI interaction; source excerpts do not show its implementation, so that relationship is documented rather than inferred from code.

Main entry points: [`jadx_mcp_server.py`](https://github.com/zinja-coder/jadx-mcp-server/blob/main/jadx_mcp_server.py) (MCP server), [`src/server/config.py`](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/config.py) (HTTP configuration), [`src/PaginationUtils.py`](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/PaginationUtils.py) (Pagination), [`src/server/tools/class_tools.py`](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/class_tools.py) (Class inspection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP entry"]
  node_server["MCP server<br/>[jadx_mcp_server.py]"]
  node_banner["Startup banner<br/>[banner.py]"]
end

subgraph group_analysis["APK analysis"]
  node_classes["Class inspection<br/>[class_tools.py]"]
  node_search["Code search<br/>[search_tools.py]"]
  node_resources["Resource analysis<br/>[resource_tools.py]"]
  node_xrefs["Cross references<br/>[xrefs_tools.py]"]
  node_debug["Runtime debugging<br/>[debug_tools.py]"]
  node_pagination["Pagination<br/>[PaginationUtils.py]"]
end

subgraph group_changes["Code changes"]
  node_refactor["Code refactoring<br/>[refactor_tools.py]"]
  node_comments["Code comments<br/>[comment_tools.py]"]
end

subgraph group_transport["Plugin transport"]
  node_config["HTTP configuration<br/>[config.py]"]
end

node_client(("MCP client"))
node_plugin["JADX AI plugin"]
node_jadx["JADX GUI"]

node_client -->|"invokes tools"| node_server
node_server -->|"dispatches"| node_classes
node_server -->|"dispatches"| node_search
node_server -->|"dispatches"| node_resources
node_server -->|"dispatches"| node_xrefs
node_server -->|"dispatches"| node_debug
node_server -->|"dispatches"| node_refactor
node_server -->|"dispatches"| node_comments
node_server -->|"loads"| node_banner
node_classes -->|"requests data"| node_config
node_search -->|"requests data"| node_config
node_resources -->|"requests data"| node_config
node_xrefs -->|"requests data"| node_config
node_debug -->|"requests data"| node_config
node_refactor -->|"requests data"| node_config
node_comments -->|"requests data"| node_config
node_classes -->|"paginates"| node_pagination
node_search -->|"paginates"| node_pagination
node_resources -->|"paginates"| node_pagination
node_xrefs -->|"paginates"| node_pagination
node_config -->|"sends HTTP requests"| node_plugin
node_plugin -->|"routes actions"| node_jadx
node_jadx -->|"returns data"| node_plugin
node_plugin -->|"returns HTTP response"| node_config

click node_server "https://github.com/zinja-coder/jadx-mcp-server/blob/main/jadx_mcp_server.py"
click node_banner "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/banner.py"
click node_classes "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/class_tools.py"
click node_search "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/search_tools.py"
click node_resources "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/resource_tools.py"
click node_xrefs "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/xrefs_tools.py"
click node_debug "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/debug_tools.py"
click node_pagination "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/PaginationUtils.py"
click node_refactor "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/refactor_tools.py"
click node_comments "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/comment_tools.py"
click node_config "https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/config.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_banner,node_client,node_jadx toneBlue
class node_classes,node_search,node_resources,node_xrefs,node_debug,node_pagination toneAmber
class node_refactor,node_comments toneMint
class node_config toneRose
class node_plugin toneIndigo
```

## Components

### MCP entry

- [MCP server](https://github.com/zinja-coder/jadx-mcp-server/blob/main/jadx_mcp_server.py): `jadx_mcp_server.py`
- [Startup banner](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/banner.py): `src/banner.py`

### APK analysis

- [Class inspection](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/class_tools.py): `src/server/tools/class_tools.py`
- [Code search](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/search_tools.py): `src/server/tools/search_tools.py`
- [Resource analysis](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/resource_tools.py): `src/server/tools/resource_tools.py`
- [Cross references](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/xrefs_tools.py): `src/server/tools/xrefs_tools.py`
- [Runtime debugging](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/debug_tools.py): `src/server/tools/debug_tools.py`
- [Pagination](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/PaginationUtils.py): `src/PaginationUtils.py`

### Code changes

- [Code refactoring](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/refactor_tools.py): `src/server/tools/refactor_tools.py`
- [Code comments](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/tools/comment_tools.py): `src/server/tools/comment_tools.py`

### Plugin transport

- [HTTP configuration](https://github.com/zinja-coder/jadx-mcp-server/blob/main/src/server/config.py): `src/server/config.py`

### Other components

- **MCP client**
- **JADX AI plugin**
- **JADX GUI**

## Connections

- MCP client → MCP server: invokes tools (evidence: `README.md`)
- MCP server → Class inspection: dispatches (evidence: `jadx_mcp_server.py`)
- MCP server → Code search: dispatches (evidence: `jadx_mcp_server.py`)
- MCP server → Resource analysis: dispatches (evidence: `jadx_mcp_server.py`)
- MCP server → Cross references: dispatches (evidence: `jadx_mcp_server.py`)
- MCP server → Runtime debugging: dispatches (evidence: `jadx_mcp_server.py`)
- MCP server → Code refactoring: dispatches (evidence: `jadx_mcp_server.py`)
- MCP server → Code comments: dispatches (evidence: `jadx_mcp_server.py`)
- MCP server → Startup banner: loads (evidence: `jadx_mcp_server.py`)
- Class inspection → HTTP configuration: requests data (evidence: `src/server/tools/class_tools.py`)
- Code search → HTTP configuration: requests data (evidence: `src/server/tools/search_tools.py`)
- Resource analysis → HTTP configuration: requests data (evidence: `src/server/tools/resource_tools.py`)
- Cross references → HTTP configuration: requests data (evidence: `src/server/tools/xrefs_tools.py`)
- Runtime debugging → HTTP configuration: requests data (evidence: `src/server/tools/debug_tools.py`)
- Code refactoring → HTTP configuration: requests data (evidence: `src/server/tools/refactor_tools.py`)
- Code comments → HTTP configuration: requests data (evidence: `src/server/tools/comment_tools.py`)
- Class inspection → Pagination: paginates (evidence: `src/server/tools/class_tools.py`)
- Code search → Pagination: paginates (evidence: `src/server/tools/search_tools.py`)
- Resource analysis → Pagination: paginates (evidence: `src/server/tools/resource_tools.py`)
- Cross references → Pagination: paginates (evidence: `src/server/tools/xrefs_tools.py`)
- HTTP configuration → JADX AI plugin: sends HTTP requests (evidence: `src/server/config.py`)
- JADX AI plugin → JADX GUI: routes actions (evidence: `README.md`)
- JADX GUI → JADX AI plugin: returns data (evidence: `README.md`)
- JADX AI plugin → HTTP configuration: returns HTTP response (evidence: `README.md`)
