Skip to main content

android-re-mcp (Python)

The live-device half of android-re-mcp. It is an MCP server that lets an AI assistant drive adb, Frida, mitmproxy, apktool and jadx against a test phone: decompile an app, hook it, read its traffic, patch it, sign it and install it again. The npm predecessor (android-re-mcp) is being retired — its static Android tools move into this package and its iOS tools are dropped (1.4.0). This package is the sole survivor.

Install

pip install "android-re-mcp[all]"
android-re-mcp --setup

It needs Python 3.11 or newer. The base install is just the MCP server. The [all] extra adds Frida, androguard, apkid, apkleaks, mitmproxy and quark-engine, and you can pick parts instead: frida, static, network, analysis. If Frida is already pinned in your environment, install without extras and the server will not touch it. --setup downloads pinned, checksum-verified copies of apktool, jadx, uber-apk-signer and Il2CppDumper into ~/tools. adb comes from your package manager (sudo apt install adb).

Connect it

Claude Code:

claude mcp add android-re -- android-re-mcp

opencode, in ~/.config/opencode/opencode.json:

{
  "mcp": {
    "android-re": { "type": "local", "command": ["/path/to/venv/bin/android-re-mcp"], "enabled": true }
  }
}

Use the full path to the command if it lives in a virtualenv. Any other client needs only the command, with no arguments. Start with a check of what is installed. Ask "Run check_tools", and the assistant lists which tools it found and which are missing.

A first session

Ask in plain language and the assistant picks the tools. Some prompts and what they use:

  • "List my devices, then push frida-server to the phone and start it." (adb_devices, frida_server_push)
  • "Decompile /home/me/apks/app.apk and search the strings for token or secret." (apk_decompile, search_strings)
  • "Which protection does com.example.app use, and how do I get past it?" (rasp_identify, rasp_bypass)
  • "Start mitmproxy, open the app on the phone, then show me the requests it made." (mitm_start, mitm_read_flows)
  • "Patch the license check in the smali, rebuild, sign and install it." (smali_patch, apk_rebuild_sign, adb_install)
  • "Dump the app's memory and look for the session key." (frida_memdump, frida_find_bytes)

The server also carries short playbooks as MCP prompts, and it keeps per-app notes (memory_read, memory_write) so a later session can pick up where the last one stopped.

What is in it

Group Tools Needs
Static apk_decompile, apk_identify, apk_scan_secrets, manifest_parse, search_strings, find_urls, find_crypto_usage apktool, jadx, ripgrep, apkid
Frida frida_spawn, frida_attach, frida_inject, frida_memdump, objection_run Frida, a rooted phone or a gadget
Device adb_devices, adb_shell, adb_install, adb_pull, adb_push, adb_logcat_*, scrcpy_* adb, scrcpy
Network mitm_start, mitm_stop, mitm_read_flows, mitm_export_har, ssl_kill_switch mitmproxy
Patching smali_patch, inject_gadget, apk_sign, apk_rebuild_sign apktool, uber-apk-signer, Java
Native and cross-platform native_strings, native_exports, native_disasm, il2cpp_dump, blutter_extract, hermes_decode radare2, Il2CppDumper, Blutter
Protections rasp_identify, rasp_bypass none

The Frida script library behind frida_list_scripts is empty until you add scripts of your own to ~/.local/share/android-re-mcp/frida_scripts. The bypass scripts in rasp_bypass are built in.

Staying safe

This server can run commands on your phone and your computer, so treat its tools with care.

  • Use stdio. --transport sse listens on 127.0.0.1 only, and any other --host needs ANDROID_RE_MCP_TOKEN, which clients send as a bearer token.
  • Set ANDROID_RE_MCP_ALLOWED_DIRS (folders separated by :) to keep file arguments inside your workspace. Paths under ~/.ssh, ~/.config/gh, shell rc files and similar are always refused.
  • Switch tools off with ANDROID_RE_MCP_DISABLE_TOOLS=adb_shell,adb_push,adb_pull, and set the risky ones to ask first in your client.
  • install_tool is off unless you set ANDROID_RE_MCP_ALLOW_INSTALL=1. --setup always works because you run it yourself.
  • mitmproxy listens on 127.0.0.1. Run adb reverse tcp:8080 tcp:8080 and point the phone's proxy at 127.0.0.1:8080.
  • A sample you analyze can try to steer the assistant through its own strings and symbol names. Use a VM, and do not auto-approve tools that touch the device.

Files

Notes, captures and scratch files live in ~/.local/share/android-re-mcp (set ANDROID_RE_MCP_HOME to move them). Settings such as your signing keystore go in ~/.config/android-re-mcp/config.toml. Downloaded tools go in ~/tools.

Credits

Derived from mobile-security-mcp 0.1.4 on PyPI (MIT), whose authors are not named. See NOTICE.md. MIT licensed.

Metadata

Release files for android-re-mcp 1.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for android-re-mcp 1.4.0
File Size Uploaded Provenance Actions
android_re_mcp-1.4.0.tar.gz 773.4 kB With provenance Details for android_re_mcp-1.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for android-re-mcp 1.4.0
File Interpreter ABI Platform Actions
android_re_mcp-1.4.0-py3-none-any.whl Python 3 none any Details for android_re_mcp-1.4.0-py3-none-any.whl

Total release size: 1.6 MB

Release files / android_re_mcp-1.4.0.tar.gz

Download URL android_re_mcp-1.4.0.tar.gz
Size 773.4 kB
Tags Source
SHA-256 checksum
How to use checksums
08af7431160012f01c2a5f3e6e25de17ae9b1a92eeffa7a44dffca14ac1e3da5
BLAKE2b-256 checksum
How to use checksums
523bfdca3e399a10afc5da68493ce62f98d6687186e48f34c5b0ad044a6c7f94
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / android_re_mcp-1.4.0-py3-none-any.whl

Download URL android_re_mcp-1.4.0-py3-none-any.whl
Size 780.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
638734c4f08f0cc3b0c4da282b16705a7bfbaa40e53257335150278cd24956f9
BLAKE2b-256 checksum
How to use checksums
9a9b2fd5fd5c76fea853f6cdf5b05d6d708ec18a3014670dc5eadefd2f49d863
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for android-re-mcp 1.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for android_re_mcp-1.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.4.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page