wlmosv-png/apk-index

零依赖的本地 APK/AAR/DEX 结构索引 + MCP Server。17 个工具，为 Xposed 模块开发提供静态反查。

About apk-index

apk-index —— Android 逆向 / Xposed 模块开发用的 APK 索引 MCP Server

静态索引 APK / split APK / AAR / 裸 dex / vdex / compact-dex，给 Agent 提供 「查类、查成员、查签名、查字符串、查交叉引用、生成 hook 起手块」的只读能力。 纯 Python 3 标准库（zipfile / sqlite3 / struct / json / hashlib），stdio 上说 MCP JSON-RPC 2.0。

运行要求 - Python = 3.10，无第三方依赖 - 可选：JDK 的 javac（AAR fixture）与 javap（.class 交叉校验）；缺省时用内置 tools/classwrite.py 兜底 - 只读挂载：索引写 APKINDEXCACHE（默认 ~/.cache/apk-index），永不写源文件

- HTTP：客户端 initialize 后回传 MCP-Session-Id 请求头 → 每个客户端一个 owner；不带头的老客户端归 default（兼容）。 - stdio：每个进程随机 owner（可用环境变量 APKINDEXOWNER 固定）。 - CLI：APKINDEXOWNER 或 cli。

隔离语义：sessionList 只显示本客户端的会话；unload 只解除自己的引用， 索引文件全局共享（同一包只建一次索引，多客户端 load 命中缓存）， 最后一个引用者释放时才删文件。跨进程写索引有文件锁（.lock）， 两个客户端同时索引同一新包不会互相踩。

APKINDEXALLOWEDROOTS（冒号分隔）是路径白名单，越界一律 INVALIDPATH —— 防止越权读宿主隐私文件。

23 个工具 分类 工具 一句话 --------- 装载 loadApk APK(+split 目录) → 会话；返回指纹 / manifest 摘要 / 组件 / 加固探测 装载 loadAar classes.jar + R.txt + consumer-rules.pro + jni/\/.so，可 mergeInto 并进 App 会话 装载 loadDex 裸 classes.dex / vdex / compact-dex，可追加进已有会话 会话 sessionList / stats / unload 忘了 sessionId 先 list；stats 看体量；unload 删登记（keepFiles 可选） 查询 searchClasses exact / prefix / regex，scope=appliball，packageFilter 查询 listMembers 类内方法与字段，include 走 namePattern 查询 getSignature 一个类或成员 → smali / reflector / java / helper-ktx 四形态 + hook 起手块 + 注解（含 visibility） 查询 searchByString 常量字符串反查方法（contains/exact/regex，按命中数聚合排序） 查询 findImplementations 接口实现 / 父类子类，含传递继承链 查询 xref callers / callees，depth 控制跳数 代码 decompile outline（骨架）/ smali / java，maxLines 截断 生成 matchSignature 只给结构条件（参数个数/类型/返回值/引用字符串）→ 候选成员 + 可粘 DSL 生成 diffSessions 两版本差分：exact-structure / s

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/wlmosv-png--apk-index.html)

Related MCP servers