JEB MCP Server

A Model Context Protocol (MCP) server that bridges Claude Desktop with JEB decompiler for Android APK analysis. This integration enables AI-assisted reverse engineering workflows directly within Claude.

Features

• Decompilation: Decompile methods and classes from DEX to Java source code
• Code Navigation: List classes, search resources, and explore cross-references
• Batch Renaming: Rename classes, methods, fields, and local variables in bulk
• Resource Analysis: Access AndroidManifest.xml, resources, and asset files
• Cross-References: Find all references to methods, fields, and strings
• Class Hierarchy: Explore class implementations and inheritance

Architecture

The system consists of two components:

1. JEB MCP Server (dJEB_mcp_server.py): Runs inside JEB as a Jython script, exposing JEB's API over a socket
2. Bridge Script (jeb_mcp_bridge.py): Connects Claude Desktop to the JEB server via stdio

Claude Desktop <--> jeb_mcp_bridge.py <--> (port 8851) <--> dJEB_mcp_server.py (JEB)

Installation

Prerequisites

• JEB Decompiler (licensed version)
• Claude Desktop

Setup

1. Clone this repository:

   git clone https://github.com/yourusername/jeb-mcp-server.git
   cd jeb-mcp-server
   

2. Configure Claude Desktop:

   Edit your Claude Desktop MCP configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

   Add the following configuration:

   {
     "mcpServers": {
       "jeb-mcp-server": {
         "command": "python3",
         "args": ["/absolute/path/to/jeb-mcp-server/jeb_mcp_bridge.py"]
       }
     }
   }
   

3. Load the script in JEB:

   • Open JEB Decompiler
   • Load your target APK file
   • Run the script: File → Scripts → Run Script... → Select dJEB_mcp_server.py
   • The server will start listening on port 8851

4. Restart Claude Desktop to load the MCP server configuration

Usage

Once configured, you can interact with JEB through Claude Desktop using natural language. The server provides the following tools:

Available Tools

Example Prompts

Here are powerful prompts you can use with the JEB MCP Server:

1. Deep-Link Analysis

Prompt:

Analyze the deep-link handling in this Android application step-by-step.
I want you to:
1. Find all activities that handle intent filters with data schemes
2. For each deep-link handler, trace the URL parsing logic
3. Extract all possible endpoints and their parameters
4. Ignore any analytics or tracking code
5. Create a comprehensive map of all deep-link endpoints with their functionality

Please be thorough and explore all related classes.

2. Intelligent Class Renaming

Prompt:

I want to rename the obfuscated class "La/b/c;" and its methods to meaningful names.

Please:
1. Decompile the class and analyze its purpose
2. Find all classes that reference or are referenced by this class
3. Examine the broader context by looking at:
   - Parent classes and interfaces
   - Classes that call its methods
   - Classes instantiated within it
4. Only renam

... [View full README on GitHub](https://github.com/dPhoeniixx/dJEB_mcp_server#readme)