StaticApkAuditor MCP

Un servidor Model Context Protocol (MCP) que expone descompilación basada en Apktool y un conjunto de heurísticas personalizadas de análisis estático para la evaluación de seguridad de APK de Android, mediante comandos en lenguaje natural en Claude Code / Claude Desktop.

Para qué sirve

Le apuntas a un APK. Lo descompila y luego le da a un asistente de IA un conjunto de herramientas para analizar el resultado: superficie de ataque, permisos, secretos codificados, uso de criptografía, bibliotecas nativas, candidatos de lógica de negocio; y contrasta los hallazgos con otras herramientas como MobSF. Cada llamada se registra en disco como un informe markdown, de modo que terminas con un rastro de auditoría, no solo una transcripción del chat.

Esto es una ayuda de análisis estático, no un pentest completo. Varias herramientas producen candidatos para verificación manual/dinámica, no vulnerabilidades confirmadas; esto se indica explícitamente en las descripciones de las herramientas y en los prompts integrados. El comportamiento en tiempo de ejecución (condiciones de carrera, bypass de flujos de trabajo, exfiltración real de datos) necesita pruebas dinámicas (Frida, Burp/mitmproxy, un dispositivo real) para confirmarse.

Related MCP server: GDA-MCP-Server

Inicio rápido

Se asume que Java, Apktool y Python 3.10+ ya están instalados (consulta Requisitos previos más abajo si no es así).

# 1. Set up the project folder
mkdir static-apk-auditor && cd static-apk-auditor

# 2. Create a venv and install the one dependency
python3 -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 3. Sanity check — should hang waiting for stdio input, Ctrl+C to stop
python3 server.py

# 4. Register with Claude Code (adjust paths to your actual location)
claude mcp add static-apk-auditor \
  --env APKTOOL_WORK_DIR=$(pwd)/data \
  -- $(pwd)/venv/bin/python3 $(pwd)/server.py

# 5. Verify it connected
claude mcp list

Luego, dentro de una sesión de claude, en la misma carpeta desde la que ejecutaste claude mcp add (el registro se limita por defecto al ámbito de esa carpeta):

/mcp__static-apk-auditor__security_audit
/absolute/path/to/some.apk

o simplemente pregunta en lenguaje natural: el modelo llamará a decode_apk y al resto de herramientas por su cuenta:

Decompile /absolute/path/to/some.apk and give me a quick security triage.

Consulta Prompts y Herramientas más abajo para ver todo lo disponible, o ejecuta /mcp en una sesión de Claude Code para explorarlos interactivamente.

Estructura del proyecto

static-apk-auditor/                  # your folder can be named anything — this is just an example
├── server.py                    # the MCP server — single file, FastMCP-based
├── requirements.txt              # just "mcp"
├── README.md                     # this file
├── prompts/
│   ├── security_audit.md         # 16-point checklist, OWASP Mobile Top 10 mapping
│   └── mobsf_review.md           # MobSF finding validation workflow
├── venv/                         # created locally, not part of the repo
└── data/                         # created automatically on first decode_apk call
                                   # (this is APKTOOL_WORK_DIR — see Configuration below)

Distribución de datos en tiempo de ejecución (se crea automáticamente)

Cada APK que analices recibe su propia carpeta autocontenida dentro de APKTOOL_WORK_DIR:

$APKTOOL_WORK_DIR/<apk_filename_without_extension>/
├── source/
│   └── <original>.apk           # copy of the APK you pointed the tool at
├── decoded/
│   ├── AndroidManifest.xml
│   ├── smali/, smali_classes2/, ...
│   ├── res/, assets/, lib/
│   └── ...                      # apktool's decompiled output
├── reports/
│   ├── 20260706_175359_809_decode_apk.md
│   ├── 20260706_175412_112_analyze_manifest.md
│   ├── 20260706_175430_501_check_root_detection.md
│   └── ...                      # one markdown file per tool call, ever
└── final_reports/
    ├── 20260706_223500_123_security_audit.md
    └── 20260706_224100_456_mobsf_review.md
                                   # the finished, synthesized reports
                                   # (Summary + Detailed Findings + Risk Table),
                                   # saved explicitly via save_final_report

Cada llamada a herramienta — sin importar qué herramienta ni si tiene éxito o falla — escribe un archivo markdown con marca de tiempo en la carpeta reports/ de ese APK. Esto no es un registro opcional por llamada; es un decorador (@logged_tool) aplicado a todas las herramientas registradas, de modo que nada de lo que llame a este servidor queda sin registrar. Cada informe contiene el nombre de la herramienta, los parámetros con los que se llamó y su salida completa.

reports/ y final_reports/ tienen propósitos distintos: reports/ es el registro bruto de llamadas (cada invocación individual de herramienta, útil para auditar exactamente qué se comprobó y cuándo), mientras que final_reports/ solo contiene los informes pulidos y legibles por humanos: el entregable real que le darías a un desarrollador o cliente. Los prompts security_audit y mobsf_review terminan ambos con una llamada obligatoria a save_final_report, que es lo que llena final_reports/; sin esa llamada, el informe sintetizado solo existe en la respuesta del chat y no se persiste en ningún sitio del disco.

Requisitos previos

1. Java JDK 8+ (requerido por Apktool)

# Ubuntu/Debian
sudo apt update && sudo apt install default-jdk

# macOS
brew install openjdk
java -version

2. Apktool

# Ubuntu/Debian
sudo apt install apktool

# macOS
brew install apktool
apktool --version

3. Python 3.10+

python3 --version

4. (Opcional) aapt — para obtener los metadatos completos de get_apk_info sin necesidad de descompilar primero

brew install aapt   # or: brew install --cask android-commandlinetools

Si aapt no está instalado, get_apk_info recurre a analizar el AndroidManifest.xml ya descompilado en lugar de fallar silenciosamente.

Instalación

git clone <your-repo-or-just-copy-the-files> static-apk-auditor
cd static-apk-auditor
python3 -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate
pip install -r requirements.txt

Comprobación básica:

python3 server.py
# Should hang waiting for stdio input (that's normal) — Ctrl+C to stop.

Conexión con Claude Code

claude mcp add apktool-pro \
  --env APKTOOL_WORK_DIR=/absolute/path/to/static-apk-auditor/data \
  -- /absolute/path/to/static-apk-auditor/venv/bin/python3 /absolute/path/to/static-apk-auditor/server.py

Verifica:

claude mcp list
claude mcp get apktool-pro   # should show "✔ Connected"

Nota: claude mcp add registra el servidor con ámbito en el directorio actual por defecto (ámbito local). Si quieres que esté disponible desde cualquier proyecto, añade --scope user.

Conexión con Claude Desktop (alternativa)

Edita tu archivo de configuración (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "apktool-pro": {
      "command": "/absolute/path/to/static-apk-auditor/venv/bin/python3",
      "args": ["/absolute/path/to/static-apk-auditor/server.py"],
      "env": {
        "APKTOOL_WORK_DIR": "/absolute/path/to/static-apk-auditor/data"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Configuración (variables de entorno)

Herramientas

Núcleo (descompilación y manifiesto)

Heurísticas de seguridad

Reconocimiento de lógica de negocio

Validación de informes MobSF

Prompts (flujos de trabajo guiados)

Los prompts se invocan explícitamente como comandos de barra en Claude Code (/apktool-pro:<name>), a diferencia de las herramientas, que el modelo llama por sí mismo según sea necesario.

Ejemplos de uso

Use decode_apk to decompile /path/to/app.apk

/apktool-pro:security_audit apk_path="/path/to/app.apk"

Use check_root_detection on the decompiled output

/apktool-pro:mobsf_review apk_path="/path/to/app.apk" mobsf_report_path="/path/to/mobsf_report.json"

Para ver todas las herramientas disponibles y sus parámetros exactos en cualquier momento, ejecuta /mcp en una sesión de Claude Code y selecciona apktool-pro.

Cómo obtener un informe de MobSF

Si estás ejecutando MobSF localmente:

# upload the APK, get back a hash
curl -F 'file=@/path/to/app.apk' http://localhost:8000/api/v1/upload \
  -H "Authorization: <MOBSF_API_KEY>"

# fetch the JSON report using that hash
curl -X POST http://localhost:8000/api/v1/report_json \
  -H "Authorization: <MOBSF_API_KEY>" \
  --data "hash=<hash_from_upload>" -o mobsf_report.json

Limitaciones conocidas

• Solo análisis estático. Nada aquí ejecuta la aplicación ni intercepta tráfico real. Los hallazgos de lógica de negocio y algunos hallazgos estáticos "confirmados" aún necesitan verificación dinámica antes de tratarlos como probados.

• La salida de build_apk no está firmada. Firma con apksigner antes de instalar en un dispositivo.

• Las heurísticas basadas en regex (check_ssl_pinning, check_root_detection, map_sensitive_flows, etc.) pueden pasar por alto código ofuscado/renombrado y pueden dar falsos positivos en coincidencias no relacionadas — trata su salida como una lista corta para revisar, no como un veredicto.

• install_framework solo es necesario para decodificar APKs de sistema/OEM que hacen referencia a framework-res.apk; la mayoría de los análisis de aplicaciones de terceros no lo necesitarán.

Notas de diseño

• APKTOOL_WORK_DIR siempre se respeta — cada APK obtiene una carpeta persistente y autocontenida (source/, decoded/, reports/, final_reports/); nada escribe en un tempdir desechable.

• get_apk_info recurre a analizar el manifiesto decodificado si aapt no está instalado, en lugar de no devolver nada útil.

• Cada llamada de herramienta se registra automáticamente (reports/); los informes finales sintetizados se guardan por separado mediante save_final_report (final_reports/).

• Construido sobre FastMCP para un registro sencillo de herramientas/prompts.

Uso legal / responsable

Solo analiza APKs que poseas o para las que tengas permiso explícito por escrito para probar. Los APKs descompilados pueden contener datos de usuario sensibles — maneja el resultado en consecuencia y limpia APKTOOL_WORK_DIR después de un engagement si contiene datos de clientes. Esta herramienta no realiza exfiltración de red ni explotación activa por sí misma; los comandos de PoC en la salida de security_audit (p. ej. adb shell am start ...) están pensados para ejecutarse manualmente contra un dispositivo/emulador que controles.