jadx-ai-mcp MCP — 사용 사례, 설치 & 라이브 데모

Name: jadx-ai-mcp MCP Server
Author: zinja-coder

왜 쓰나요

핵심 기능

25+ MCP tools for Android APK analysis, refactoring, and debugging
Real-time decompiled code access with AI recommendations
Cross-reference tracking for classes, methods, and fields with pagination
Code refactoring: rename classes, methods, fields, packages, and variables
Debugger integration with stack frames, threads, and variable inspection

라이브 데모

실제 사용 모습

jadx-ai-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jadx-ai-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/zinja-coder/jadx-ai-mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "jadx-ai-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/zinja-coder/jadx-ai-mcp"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "jadx-ai-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/zinja-coder/jadx-ai-mcp"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "jadx-ai-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/zinja-coder/jadx-ai-mcp"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "jadx-ai-mcp",
      "command": "TODO",
      "args": [
        "See README: https://github.com/zinja-coder/jadx-ai-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "jadx-ai-mcp": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/zinja-coder/jadx-ai-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add jadx-ai-mcp -- TODO 'See README: https://github.com/zinja-coder/jadx-ai-mcp'

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: jadx-ai-mcp

How to analyze an Android APK with AI assistance using JADX

👤 Mobile security researchers analyzing APKs they have authorization to test ⏱ ~45 min intermediate

언제 쓸까: You have an APK to analyze and want AI to help understand its behavior.

사전 조건

JADX with jadx-ai-mcp plugin — jadx plugins --install 'github:zinja-coder:jadx-ai-mcp'
JADX MCP Server running — Set up the Python MCP server with uv

흐름

Check the manifest

Get the AndroidManifest.xml. What permissions does this app request and what components (activities, services, receivers) does it declare?✓ 복사됨

→ Parsed manifest with permission analysis
Find interesting classes

Search for classes related to network communication or encryption. List them with their methods.✓ 복사됨

→ Filtered class list with method signatures
Analyze and rename

Get the source code of the main network class. Rename obfuscated methods to descriptive names based on their behavior.✓ 복사됨

→ Decompiled code with meaningful names applied

결과: An annotated view of the APK with key functionality understood and obfuscation partially reversed.

함정

Heavily obfuscated apps resist decompilation — Use get_smali_of_class for bytecode-level analysis when decompilation fails

함께 쓰기: filesystem

Debug an Android app with AI-assisted breakpoint analysis

👤 Android developers and security researchers debugging app behavior ⏱ ~30 min advanced

언제 쓸까: You need to understand runtime behavior that isn't clear from static analysis.

사전 조건

JADX configured for debugging — Connect JADX debugger to a running Android app or emulator

흐름

Set breakpoints and inspect

I'm debugging the login flow. Show me the current stack frames and local variables at the authentication method.✓ 복사됨

→ Stack trace with variable values at the breakpoint

결과: Runtime understanding of app behavior at critical code points.

함정

App detects debugger and exits — Look for anti-debugging checks in the code and bypass them before attaching

조합

다른 MCP와 조합해 10배 효율

jadx-ai-mcp + filesystem

Export decompiled and annotated code for documentation

Export the decompiled source of the authentication module and save it to ~/analysis/auth-module.java.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
fetch_current_class	none	Get the currently selected class source code
search_classes_by_keyword	keyword: str	Find classes matching a keyword
get_android_manifest	none	Retrieve the AndroidManifest.xml
rename_class	old_name: str, new_name: str	Rename an obfuscated class
xrefs_to_method	class_name: str, method_name: str	Find all references to a method
get_smali_of_class	class_name: str	Get Dalvik bytecode (smali) for a class
debug_get_stack_frames	none	Get current debugger stack frames

비용 및 제한

운영 비용

API 쿼터: N/A — fully local
호출당 토큰: 200–2000 tokens per tool call
금액: Free — both JADX and the plugin are open source
팁: Use search_classes_by_keyword to narrow targets before fetching full class sources.

보안

권한, 시크릿, 파급범위

자격 증명 저장: N/A

데이터 외부 송신: All analysis is local. No network calls from the MCP server.

⚠ This tool is designed for authorized security research, CTF competitions, and defensive analysis only. Do not use it against systems you don't own or have written authorization to test.
Only analyze APKs you have legal right to reverse engineer.

문제 해결

자주 발생하는 오류와 해결

Plugin not loading in JADX

Ensure JADX version is compatible. Try reinstalling with: jadx plugins --install 'github:zinja-coder:jadx-ai-mcp'

확인: jadx plugins --list

MCP server connection failed

Ensure the JADX MCP Server is running and the port matches your client config.

확인: Check the server terminal for startup messages

Class not found in search

Obfuscated names may not match your search. Try broader patterns or search by method signatures.

확인: get_all_classes to see available class names

대안

jadx-ai-mcp 다른 것과 비교

대안	언제 쓰나	단점/장점
jadx-mcp-server	You only need the MCP server component without the JADX plugin	Server-only — still needs the jadx-ai-mcp plugin in JADX
GhidrAssistMCP	You want to analyze native binaries rather than Android Dalvik bytecode	Native binary focus vs Android-specific tools

jadx-ai-mcp

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: jadx-ai-mcp

How to analyze an Android APK with AI assistance using JADX

사전 조건

흐름

함정

Debug an Android app with AI-assisted breakpoint analysis

사전 조건

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

jadx-ai-mcp 다른 것과 비교

더 보기

리소스