Jadx MCP Server

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

本项目提供了一个用 Java 编写的 Jadx 插件，它通过 HTTP 暴露 Jadx API — 从而可以通过 模型上下文协议 (MCP) 实现与 Claude 的实时交互。一个轻量级的 Python FastMCP 适配器充当 Claude 和插件之间的桥梁。

---

🧰 安装说明

# 克隆此仓库
git clone https://github.com/mobilehackinglab/jadx-mcp-plugin.git
cd jadx-mcp-plugin

# 创建并激活虚拟环境
python3 -m venv venv

# 激活:
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 并添加一个指向 venv 中 Python 可执行文件的 MCP 服务器（以防止依赖问题）和完整的适配器路径，如下面的示例所示：

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. Claude 将检测并激活 Jadx MCP Server 工具
4. 现在，您可以实时列出类、获取源代码、检查方法/字段以及提取代码

---

🧪 提供的工具

工具	描述
list_all_classes	获取所有反编译的类名
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 端点

要构建插件：

./gradlew build
# 输出: plugin/build/libs/jadx-mcp-plugin-<version>-all.jar

将 .jar 放入您的 Jadx plugins/ 文件夹中。

---

Python FastMCP 适配器

适配器文件是：

fastmcp_adapter.py

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

---

🤝 贡献

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

---

🧩 鸣谢

• Jadx
• FastMCP
• Anthropic 的 Claude