Permet aux agents IA d'interroger des fichiers Android APK et DEX via SQL pour analyser les classes, les méthodes, les chaînes de caractères et le code smali.
Aussi connu sous LSPosed/dexsql-release, dexsql-release
- Étoiles
- 316
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.1
- Dernier commit
- 25 oct. 2026
- Licence
- —
Qu'est-ce que DexSQL MCP ?
Permet aux agents IA d'interroger des fichiers Android APK et DEX via SQL pour analyser les classes, les méthodes, les chaînes de caractères et le code smali.
Résumé généré à partir du README du projet
À propos du MCP server DexSQL
DexSQL offre aux agents IA un moyen d'effectuer des analyses structurées sur les fichiers Android APK et DEX en utilisant SQL. Il permet aux utilisateurs d'interroger des éléments spécifiques tels que les classes, les méthodes, les chaînes de caractères et le code smali via une ligne de commande ou une connexion MCP. Cet outil est conçu pour les développeurs et les chercheurs en sécurité qui ont besoin d'extraire des données précises à partir de binaires Android sans inspection manuelle.
Le serveur s'exécute localement et se connecte à des clients IA comme Claude Desktop ou Codex via stdio MCP. Il peut être installé via la Skills CLI ou par configuration manuelle de l'exécutable sur macOS, Linux ou Windows. Comme il lit directement les fichiers DEX et réutilise les jeux de données chargés, il maintient une faible empreinte mémoire et offre une faible latence pour les requêtes répétées. Les utilisateurs peuvent interagir avec lui en fournissant un chemin vers un APK et en exécutant des commandes SQL pour trouver des références d'appels ou des valeurs de chaînes de caractères spécifiques.
Ce que vous pouvez faire avec
- 1Analyser les relations d'appels de méthodesUn agent IA peut identifier quelles méthodes font référence à un message de log spécifique et récupérer leurs appelants ainsi que le code smali.
- 2Rechercher des points de terminaison API spécifiquesUn développeur peut utiliser une requête SQL pour trouver toutes les méthodes contenant une chaîne d'URL particulière au sein d'un APK.
- 3Extraire les informations de licence tiercesVous pouvez utiliser la ligne de commande pour extraire toutes les mentions de licence d'une application dans un fichier unique.
- 4Effectuer une analyse binaire multi-fichiersL'outil permet d'interroger plusieurs fichiers DEX simultanément en répétant le flag d'entrée.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)No licenseFaille
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireNon vérifié
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésNon vérifié
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
README
Voir sur GitHubDexSQL
English | 简体中文
SQL for Android binaries.
Query classes, methods, strings, and call references in APK and DEX files. Connect it to an AI agent through MCP, or use it from the command line.
Playground · Documentation · Download · Install skill · Benchmarks
Why DexSQL?
AI agents can combine signatures, strings and call relationships in one SQL query across DEX files, returning just the structured results they need. Queries can be generated, refined and saved in scripts for reuse.
DexSQL reads DEX directly and reuses loaded datasets, supporting repeated queries with low latency and a small memory footprint. See the benchmarks for measurements.
The built-in MCP server connects directly to agents, with no GUI required.
flowchart LR
A["AI client"] -->|stdio MCP| D["DexSQL"]
D --> F["APK / DEX"]
A -->|stdio MCP| P["JADX-MCP · Python"]
P -->|HTTP| J["JADX GUI + plugin · JVM"]
J --> F
Use with an AI agent
DexSQL is listed in the official MCP Registry as org.lsposed/dexsql. Clients that install servers from the registry can add it directly, and Claude Desktop can open the dexsql.mcpb bundle from Releases. The bundle covers macOS, x86_64 Linux and x86_64 Windows; on other platforms, use the skill or manual setup below.
Install the setup skill with the Skills CLI:
npx skills add LSPosed/dexsql-release --skill install-dexsql
Then ask your agent to use install-dexsql to install DexSQL and configure its MCP connection. In Codex, invoke it as $install-dexsql.
The skill downloads a compatible binary from Releases, verifies its SHA-256 checksum, adds the MCP configuration, and checks the connection. It can also use a local executable. The command above installs the skill; the agent performs the actual setup when you invoke it.
Open Releases and choose the executable or archive that matches your operating system and CPU architecture. Check the selected release's assets and notes for availability and system requirements. Extract the archive if needed, then rename the executable to dexsql.exe on Windows or dexsql on macOS/Linux. On macOS/Linux, run chmod +x /path/to/dexsql.
Save LICENSE and LICENSE-AUXILIARY from the same Release alongside the executable, then register its absolute path. For Codex:
codex mcp add dexsql -- /absolute/path/to/dexsql mcp
For clients that use mcpServers JSON:
{
"mcpServers": {
"dexsql": {
"command": "/absolute/path/to/dexsql",
"args": ["mcp"]
}
}
}
On Windows, use dexsql.exe and escape backslashes in JSON, for example "D:\\Tools\\dexsql.exe". Reload the client's MCP connection if needed. See the Codex MCP documentation for client settings.
Once connected, try:
Open
/path/to/app.apk. Find methods referencing this log message, list their callers, and show the relevant Smali.
The server provides its schema and documentation through MCP resources. APK parsing runs locally and leaves the input unchanged. The AI client's settings determine which results are sent to its model.
Performance
A real MCP session
An AI agent analyzed Douyin 40.7.0 (343 MiB, 56 DEX files) through the DexSQL MCP server. We replayed its analysis goals on DexSQL 0.1.1 and six other tools: rasc (the Rust implementation of ASC), DexDec, ddc, the JADX API, garlic and droidsaw.
Opening the APK once and answering 10 goals took 0.71 s with DexSQL, 1.69 s with rasc, 16 s with DexDec and from 75 s to 449 s with the others. DexSQL pays 0.38 s to open the APK once per session; rasc has no open but rereads the APK in every step, so a session with a single question finishes sooner with rasc. Some tools did not show all expected evidence; those misses are still under review. See the replay report for every goal, each tool's interface, the method and the harness.
Fixed queries on QQ
Eight queries run against the same QQ 9.3.55 APK, about 372 MiB: class and method lookup, string references, direct and two-hop callers, and compound predicates. The comparison includes JADX, zinja-coder's JADX-MCP, ASC, DexDec, ddc, garlic, and droidsaw.
Startup time includes process launch, loading and preparation, and the first exact class lookup; values are medians of three runs. The OS file cache was not flushed.
Queries use the median of nine repeats across three prepared workflows. garlic restarts MCP for each call; that cost is included. droidsaw CLI uses three separate invocations, each including loading. Each query uses one linear chart starting at zero. Bars exceeding the axis limit are clipped, marked with an arrow and labeled with their actual time. Hatched bars mean the query did not finish within 60 seconds. Gray entries explain missing comparisons.
Direct and two-hop queries return 15 and 16 methods. Each compound query returns one method. Every completed, plotted result set is checked. The JADX native adapter reads metadata and DEX instructions directly; it does not decompile the whole APK to find references.
Memory uses a 50 ms polling wait across the whole process tree. Light bars cover the common load-and-class-lookup workflow; dark bars cover each tool's executed cases. Summed RSS can count shared pages more than once. Private committed memory and the footprint at readiness are also recorded.
DexDec's reference cache makes its repeated caller query faster than DexSQL in this run. droidsaw's MCP rejects the input under its fixed parse budget, so its CLI is plotted. See the report for first-query and preparation times, interface differences, SQL, result hashes and reproduction scripts.
CLI
dexsql query --input app.apk --sql "SELECT DISTINCT method FROM method_strings WHERE value = 'https://api.example.com'"
dexsql query --input app.apk --interactive
dexsql extract licenses --output THIRD_PARTY_NOTICES
dexsql --help
Repeat --input to query multiple files together. The same executable provides the CLI and MCP server.
License
DexSQL is closed-source software from LSPosed, licensed under the DexSQL Binary License 1.0. Personal and commercial use, integration, and binary redistribution are free under its terms.
The public installation skill, benchmark materials, and documentation use the MIT License.
Third-party materials retain their own licenses. Run dexsql extract licenses to view their notices.
Questions sur DexSQL MCP
Que puis-je interroger dans un fichier APK avec DexSQL ?
Vous pouvez interroger les classes, les méthodes, les chaînes de caractères et les références d'appels au sein des fichiers APK et DEX en utilisant SQL.
Est-ce que DexSQL modifie les fichiers APK d'origine ?
Non, le processus d'analyse de l'APK s'exécute localement et ne modifie pas les fichiers d'entrée.
Puis-je utiliser DexSQL en ligne de commande ?
Oui, l'exécutable fournit à la fois le MCP server et une interface en ligne de commande pour exécuter des requêtes et extraire des licences.