APK MCP Auto
本项目是一个 Android 逆向工程工具集合，通过 MCP (Model Context Protocol) 协议将 AI 助手（如 Claude）与专业的 Android 反编译工具连接起来，实现智能化的 APK 分析与修改。
What is APK MCP Auto?
APK MCP Auto is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 本项目是一个 android 逆向工程工具集合，通过 mcp (model context protocol) 协议将 ai 助手（如 claude）与专业的 android 反编译工具连接起来，实现智能化的 apk 分析与修改。
本项目是一个 Android 逆向工程工具集合，通过 MCP (Model Context Protocol) 协议将 AI 助手（如 Claude）与专业的 Android 反编译工具连接起来，实现智能化的 APK 分析与修改。
This server falls under the Security and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 本项目是一个 Android 逆向工程工具集合，通过 MCP (Model Context Protocol) 协议将
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx apkmcp-autoConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use APK MCP Auto
APK MCP Auto is a Windows-based Android reverse engineering toolkit that connects AI assistants (Claude, Cursor, and others) to a suite of professional APK analysis tools through the Model Context Protocol. It bundles seven specialized MCP servers — JADX for decompilation, APKTool for Smali editing, ADB for device interaction, a static analyzer for permission and endpoint extraction, a diff tool for comparing APK versions, signing tools for re-signing modified APKs, and Frida for dynamic hooking and runtime analysis. Each tool runs as an independent local server, giving AI agents a complete reverse engineering pipeline through natural language.
Prerequisites
- Windows 10 or Windows 11 (the tooling bundle targets Windows)
- Python 3.10+ installed
- OpenJDK 17 (included in the tools/bin/jre directory of the repo)
- 8 GB RAM minimum (16 GB recommended for large APK analysis)
- ADB installed and in PATH for device interaction tools
Clone the repository
Clone the ApkMCP-Auto repository. All tool binaries and JRE are included in the tools/ directory, so no separate download is needed for most components.
git clone https://github.com/kggzs/ApkMCP-Auto.git
cd ApkMCP-AutoInstall all tool dependencies
Run the unified installer which downloads and configures all seven tool components (JADX, APKTool, Frida, etc.).
python apkmcp.py installGenerate the MCP configuration
Generate the MCP server configuration file. The config uses relative paths for portability. Preview it first, then write it to the default location.
# Preview configuration
python apkmcp.py config -p
# Generate to default location (.trae/config.json)
python apkmcp.py configStart all MCP servers
Launch all seven tool servers at once. Each runs on its own port (8651-8657). Alternatively, start individual servers for specific tools only.
# Start all servers
python start_all_servers.py
# Or via batch file
start-servers.bat all
# Or start a single server
python apkmcp.py start apktoolConfigure your AI client
Add the individual tool servers to your AI client's MCP configuration. Each server is registered separately. Here is the APKTool server as an example — repeat for the others (JADX on 8651, ADB on 8653, etc.).
{
"mcpServers": {
"apktool-mcp-server": {
"command": "python",
"args": [
"tools/apktool/server.py",
"--workspace", "tools/workspace/apktool",
"--apktool-path", "tools/bin/apktool.bat"
]
},
"jadx-mcp-server": {
"command": "python",
"args": [
"tools/jadx/server.py",
"--workspace", "tools/workspace/jadx"
]
}
}
}Verify server status
Check which servers are running and confirm all required ports are active before starting your analysis.
python apkmcp.py statusAPK MCP Auto Examples
Client configuration
Example claude_desktop_config.json showing the APKTool and JADX MCP servers registered for APK reverse engineering.
{
"mcpServers": {
"apktool-mcp-server": {
"command": "python",
"args": [
"C:/ApkMCP-Auto/tools/apktool/server.py",
"--workspace", "C:/ApkMCP-Auto/tools/workspace/apktool",
"--apktool-path", "C:/ApkMCP-Auto/tools/bin/apktool.bat"
]
},
"jadx-mcp-server": {
"command": "python",
"args": [
"C:/ApkMCP-Auto/tools/jadx/server.py",
"--workspace", "C:/ApkMCP-Auto/tools/workspace/jadx"
]
}
}
}Prompts to try
Use these prompts with Claude to drive the Android reverse engineering pipeline.
- "Decompile target.apk using APKTool and show me the AndroidManifest.xml."
- "Use JADX to decompile the APK and find all classes that make network requests."
- "Run a static analysis on the APK and list all permissions it requests."
- "Hook the login function at runtime with Frida and log the arguments."
- "Compare the original APK with the modified version and show the Smali differences."Troubleshooting APK MCP Auto
Java errors on startup — 'java not found' or version mismatch
APK MCP Auto bundles OpenJDK 17 in tools/bin/jre. Ensure JAVA_HOME is set to this directory or that the bundled JRE takes precedence in PATH. Run 'python apkmcp.py status' to see which components are misconfigured.
Port conflicts — server fails to start on its default port
Check which ports are in use with 'netstat -ano | findstr :8651' (replace with the relevant port 8651-8657). Kill the conflicting process or edit the server startup arguments to use a different port.
Frida server cannot attach to a process on the connected device
Ensure ADB is connected and the device is visible ('adb devices'). Frida requires either a rooted device or a patched APK with the Frida gadget embedded. For non-rooted devices, rebuild the APK with the gadget and use APKTool + Sign Tools to re-sign it before installing.
Frequently Asked Questions about APK MCP Auto
What is APK MCP Auto?
APK MCP Auto is a Model Context Protocol (MCP) server that 本项目是一个 android 逆向工程工具集合，通过 mcp (model context protocol) 协议将 ai 助手（如 claude）与专业的 android 反编译工具连接起来，实现智能化的 apk 分析与修改。 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install APK MCP Auto?
Follow the installation instructions on the APK MCP Auto GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with APK MCP Auto?
APK MCP Auto works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is APK MCP Auto free to use?
Yes, APK MCP Auto is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
APK MCP Auto Alternatives — Similar Security Servers
Looking for alternatives to APK MCP Auto? Here are other popular security servers you can use with Claude, Cursor, and VS Code.
Casdoor
★ 13.6kAn open-source Agent-first Identity and Access Management (IAM) /LLM MCP & agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD
ghidraMCP
★ 9.0kAn Model Context Protocol server that enables LLMs to autonomously reverse engineer applications by exposing Ghidra's decompilation and analysis tools. It allows AI agents to list code structures, rename methods, and analyze binaries directly through
HexStrike AI
★ 8.9kHexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomously run 150+ cybersecurity tools for automated pentesting, vulnerability discovery, bug bounty automation, and security research. Seamlessly b
IDA Pro MCP
★ 8.7kEnables AI-assisted reverse engineering in IDA Pro by providing tools to analyze binaries, decompile functions, manage comments, search patterns, and interact with the IDA database through natural language.
Anthropic Cybersecurity Skills
★ 6.6k754 structured cybersecurity skills for AI agents · Mapped to 5 frameworks: MITRE ATT&CK, NIST CSF 2.0, MITRE ATLAS, D3FEND & NIST AI RMF · agentskills.io standard · Works with Claude Code, GitHub Copilot, Codex CLI, Cursor, Gemini CLI & 20+ platform
Hooker
★ 5.1k🔥🔥 hooker is a Frida-based reverse engineering toolkit for Android. It offers a user-friendly CLI, universal scripts, auto hook generation, memory roaming to detect activities/services, one-click SOCKS5 proxy setup, Frida JustTrustMe, and BoringSSL u
Browse More Security MCP Servers
Explore all security servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up APK MCP Auto in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use APK MCP Auto?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.