Jadx Mcp Plugin

⚙️ Jadx MCP 插件 — 通过 MCP 为 Claude 提供反编译访问能力

本项目提供了一个使用 Java 编写的 Jadx 插件，可通过 HTTP 暴露 Jadx API，从而支持通过 Model Context Protocol (MCP) 与 Claude 等 MCP 客户端实时交互。一个轻量级的 FastMCP Python 适配器充当 Claude 与插件之间的桥梁。这使逆向工程工作流能够实现智能导航与自动化，非常适合用于 Android 应用的 AI 辅助安全分析。

---

🧰 安装说明

# 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

安装 Python 依赖项

pip install -r requirements.txt 

🧠 配置 Claude MCP 客户端集成

要在 Claude Desktop 中使用此适配器，请依次前往 File -> Settings -> Developer -> Edit Config -> claude_desktop_config.json，并添加一个 MCP 服务，指向虚拟环境中的 Python 可执行文件（以避免依赖问题）以及适配器的完整路径，示例如下：

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"]
    }
  }
}

编辑配置后，请务必重启（退出）Claude。 重启后，界面应如下所示：

✅ 使用流程

1. 打开 Jadx，并将 发布页中的最新插件 JAR 放入其 plugins/ 文件夹，或通过 Plugins -> install plugin 加载。

2. 加载 APK 或 DEX 文件

3. （可选）启动 Jadx 时，可以指定 HTTP 接口地址：

   jadx-gui -Pjadx-mcp.http-interface=http://localhost:8085
   

   如果想更改默认主机/端口（http://localhost:8085），此设置会很有用。

   Note: 如果在此处更改接口地址，请务必同时更新 fastmcp_adapter.py 中对应的 URL，使其保持一致。

4. Claude 会检测并激活 Jadx MCP 服务工具。

5. 现在，你可以列出类、获取源码、检查方法/字段，并实时提取代码。

---

🧪 提供的工具

工具	描述
list_all_classes	获取所有反编译后的类名
search_class_by_name	查找名称与字符串匹配的类
get_class_source	获取指定类的完整源码
search_method_by_name	查找名称与字符串匹配的方法
get_methods_of_class	列出类中的所有方法名
get_fields_of_class	列出类中的所有字段名
get_method_code	提取方法的反编译代码

---

🛠 开发

☕ Java 插件

Java 插件位于：

plugin/src/main/java/com/mobilehackinglab/jadxplugin/McpPlugin.java

它使用 JadxPlugin API（jadx.api.*）来：

• 加载反编译后的类和方法
• 通过内嵌 HTTP 服务提供结构化数据
• 响应 /invoke 和 /tools 端点

🚀 使用 Gradle 任务自动安装

你可以使用以下 Gradle 任务，一步完成插件的构建与安装：

./gradlew installPlugin

此任务使用 jadx plugins CLI。请确保已安装 Jadx，且其位于 PATH 中。

对于其他插件相关任务（卸载、启用/禁用），请参阅 plugin/build.gradle 中的任务定义。

🔧 手动安装

要构建插件：

./gradlew build
# Output: plugin/build/libs/jadx-mcp-plugin-<version>.jar

使用 jadx plugins CLI 安装插件 JAR：

jadx plugins --install-jar path/to/jadx-mcp-plugin-<version>.jar

也可以将构建好的 .jar 文件放入 Jadx 的 plugins/ 文件夹，通常位于：~/.jadx/plugins/

如果手动放入 JAR，还需要通过 Jadx GUI 启用插件，或运行：

jadx plugins --enable jadx-mcp

---

Python FastMCP 适配器

适配器文件为：

fastmcp_adapter.py

它会将 Claude 的 MCP 工具调用转换为发送给正在运行的 Jadx 插件服务的 HTTP POST 请求。启动 Claude 之前，请确保 Jadx 已打开。

---

🤝 参与贡献

欢迎提交 PR、功能请求和工具扩展！
本项目由 Mobile Hacking Lab 维护。

---

🧩 致谢

• Jadx
• FastMCP
• Claude by Anthropic