Skip to content

Wael-Rd/ultimate-mobile-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”₯ Ultimate Mobile Pentest MCP

v2.0.0

MCP Protocol License: MIT Platform Tools Build Stars

The first unified MCP server that bridges the entire mobile application security arsenal into a single, AI-orchestrated endpoint.

Give your AI agent a scalpel. Give it a sledgehammer. Give it both.

Claude Β· Gemini Β· Cursor Β· Windsurf Β· Any MCP-Compatible AI Client

DECOMPILE Β· PATCH Β· REPACK Β· BYPASS Β· INSTRUMENT Β· OWN


⚑ Architecture

flowchart TD
    A["πŸ€– AI Client\n(Cursor Β· Claude Β· Gemini Β· etc.)\nvia MCP JSON-RPC over stdio"]
    A --> B

    subgraph B["πŸ”₯ Ultimate Mobile Pentest MCP"]
        P["βš™οΈ 6-Layer Token Optimization Pipeline\nLRU Cache β†’ Tiering β†’ Diffing β†’ Summary β†’ Gzip β†’ Artifact Offload"]
        P --> E1 & E2 & E3 & E4 & E5 & E6
        E1[" ADB\n21 tools"]
        E2[" Frida\n14 tools"]
        E3[" Objection\n13 tools"]
        E4[" MobSF\n10 tools"]
        E5[" JADX\n9 tools"]
        E6[" APKTool\n10 tools"]
    end

    E1 --> D1["Device"]
    E2 --> D2["Memory"]
    E3 --> D3["Runtime"]
    E4 --> D4["Web UI"]
    E5 --> D5["Java"]
    E6 --> D6["Smali"]
Loading

🧠 The Context Window Problem β€” Annihilated

A single decompiler listing can generate 100KB+ of output β€” that's 30,000+ tokens gone in one command. Three commands and your context is dead.

πŸ›‘οΈ The 6-Layer Defense

# Layer What It Does Tokens Saved
1 LRU Cache Identical calls return instantly β€” zero execution, zero tokens 100% on repeats
2 Tiered Delivery minimal Β· summary Β· full β€” AI picks what it needs 60 – 80%
3 Smart Diffing Sends only what changed between repeated polling calls 85 – 95%
4 Summary Extraction RegExp matchers strip boilerplate, surface only critical findings 50 – 70%
5 Gzip Compression Artifacts stored compressed, preserving local disk 70% size cut
6 Artifact Offloading Dumps >500 lines saved as .md β€” AI gets path + summary only 95%+
Before:  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ  100,000 tokens
After:   β–ˆβ–ˆβ–ˆβ–ˆ                                   11,600 tokens  (88.4% saved)

πŸ› οΈ Arsenal β€” 83 Tools, 6 Engines

ADB Engine β€” 21 Tools
Category Tools
Device Management adb_devices Β· adb_getprop Β· adb_port_forward
Application Operations adb_install Β· adb_uninstall Β· adb_clear_data Β· adb_list_packages
Security Inspection adb_dump_package Β· adb_list_permissions (auto-flags dangerous) Β· adb_list_activities Β· adb_check_debuggable
Shell & Filesystem adb_shell Β· adb_pull Β· adb_push
Debug & Monitor adb_logcat (noise-filtered) Β· adb_screenshot Β· adb_backup
Intent Manipulation adb_start_activity Β· adb_start_service Β· adb_broadcast
Frida Instrumentation β€” 14 Tools
Category Tools
Session Management frida_ps Β· frida_ps_apps Β· frida_spawn Β· frida_attach Β· frida_kill
Scripting & Evaluation frida_eval (arbitrary JS into process memory) Β· frida_trace (native method tracer) Β· frida_enum_classes
⭐ Bypass & Hook Injectors frida_hook_ssl_pinning (universal SSL bypass) · frida_hook_root_detection · frida_hook_crypto (live AES/DES/RSA key extraction) · frida_hook_intent · frida_hook_shared_prefs · frida_dump_ui
Objection Runtime β€” 13 Tools
Category Tools
Inspection objection_explore Β· objection_env Β· objection_clipboard
Bypass objection_sslpinning_disable
File System & Data objection_ls Β· objection_cat Β· objection_download Β· objection_sqlite_dump (auto-extracts all SQLite tables) Β· objection_dump_keys (full keystore dump)
Android / iOS Specifics objection_list_activities Β· objection_list_services Β· objection_list_receivers Β· objection_search_classes Β· objection_list_class_methods Β· objection_plist_read
MobSF Cloud Client β€” 10 Tools
Category Tools
Core mobsf_upload Β· mobsf_scan Β· mobsf_delete_scan Β· mobsf_recent_scans
Reports mobsf_report_json (machine-readable static analysis) Β· mobsf_pdf_report (visual PDF dossier)
Dynamic mobsf_dynamic_start Β· mobsf_dynamic_stop Β· mobsf_frida_logs Β· mobsf_api_info
JADX Decompiler β€” 9 Tools
Category Tools
Decompile Core jadx_decompile Β· jadx_decompile_resources Β· jadx_read_source
⭐ Automated Security Audits jadx_search_secrets (hardcoded API keys, Firebase URLs) · jadx_search_crypto (MD5/SHA-1/ECB insecure usage) · jadx_search_urls (endpoints, domains, IPs from bytecode) · jadx_search_permissions (dangerous permission call sites)
Navigation jadx_list_classes Β· jadx_show_structure
APKTool Engine β€” 10 Tools
Category Tools
Core apktool_decode (smali + raw resource disassembly) Β· apktool_build (rebuilds folder back into binary APK)
Inspection apktool_read_manifest Β· apktool_list_resources Β· apktool_read_resource
⭐ Surgical Patch Suite apktool_patch_manifest (debuggable / perms / visibility) Β· apktool_read_smali Β· apktool_patch_smali (opcode injection) Β· apktool_search_smali (regex search across all smali) Β· apktool_patch_and_rebuild (decode β–Ά patch β–Ά build β–Ά sign)
Meta & Workflow β€” 6 Tools
Tool Description
pentest_workflow Full static pipeline in a single command
check_tools Dependency health check
token_stats Live optimization dashboard
read_artifact Read offloaded file payloads

Installation

Step 1 β€” Prerequisites

🐧 Ubuntu / Kali / WSL
sudo apt install -y adb apktool jadx python3-pip npm
pip3 install frida-tools objection

# Optional: MobSF via Docker
docker run -it --rm -p 8000:8000 opensecurity/mobsf:latest
macOS
brew install adb apktool jadx
pip3 install frida-tools objection

# Optional: MobSF via Docker
docker run -it --rm -p 8000:8000 opensecurity/mobsf:latest

Step 2 β€” Clone & Build

git clone https://github.com/Wael-Rd/ultimate-mobile-mcp.git
cd ultimate-mobile-mcp
npm install && npm run build

Step 3 β€” Register (Claude Desktop β€” One Command)

npm run register
# βœ“ Detected OS config path
# βœ“ Injected mobile-pentest server entry
# βœ“ Restart Claude Desktop to activate

βš™οΈ Manual Config

Cursor / Windsurf

{
  "mcpServers": {
    "mobile-pentest": {
      "command": "node",
      "args": ["/absolute/path/to/ultimate-mobile-mcp/dist/index.js"],
      "env": {
        "MOBSF_URL": "http://127.0.0.1:8000",
        "MOBSF_API_KEY": "YOUR_MOBSF_API_KEY_HERE"
      }
    }
  }
}

Claude Desktop Config Paths

OS Path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
🐧 Linux ~/.config/Claude/claude_desktop_config.json

πŸ’‘ Real-World Prompts

Full Automated Scan

"Run a full pentest_workflow on test.apk and report all high-severity findings."

Decompiles Β· parses manifest Β· scans secrets Β· audits crypto Β· outputs a single MD dossier

πŸ”“ SSL Pinning Bypass

"Launch frida_hook_ssl_pinning on process com.insecure.bank so I can proxy traffic."

Spawns under Frida Β· injects universal bypass Β· logs intercepted traffic in real time

πŸ”§ Patch APK & Recompile

"Add android:debuggable=true to the manifest and recompile with apktool_patch_and_rebuild."

Injects flag Β· patches smali check Β· rebuilds APK Β· signs it Β· done

πŸ”‘ Live Crypto Key Extraction

"Inject crypto tracer into com.insecure.bank and show me raw AES keys from login."

Hooks cryptographic APIs Β· dumps live keys Β· captures payload before encryption


πŸ“Š Performance

╔══════════════════════════════════════════════════╗
β•‘           MCP OPTIMIZATION METRICS              β•‘
╠══════════════════════╦═══════════════════════════╣
β•‘  Total Calls Logged  β•‘  83                      β•‘
β•‘  Raw Bytes Processed β•‘  2.4 MB                  β•‘
β•‘  LLM Context Saved   β•‘  1,840,000 tokens        β•‘
β•‘  Compression Ratio   β•‘  88.4%                   β•‘
╠══════════════════════╩═══════════════════════════╣
β•‘                                                  β•‘
β•‘  Raw    β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ  100%          β•‘
β•‘  After  β–ˆβ–ˆβ–ˆβ–ˆ                      11.6%  πŸ”₯     β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

Run token_stats at any time to view your live dashboard.


⚠️ Legal Disclaimer

This tool is intended STRICTLY for:

  • βœ… Authorized security research
  • βœ… Application security auditing
  • βœ… Bug bounty evaluations with explicit scope

Usage against targets without explicit written consent is ILLEGAL under the CFAA, Computer Misuse Act, and equivalent laws worldwide.

The author assumes ZERO liability for misuse. You own your actions. Use responsibly.


πŸ“„ MIT License Β· πŸ› Issues Β· ⭐ Star this repo Β· 🍴 Fork it


Built with ❀️ by Wael-Rd

GitHub

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors