奈何桥 PosEdMCP v1.1.5

项目地址： https://github.com/yunqinglt/PosEdMCP

一、 项目简介

奈何桥 (PosEdMCP) 是一款将 Android 动态插桩框架与大语言模型（LLM）能力相结合的开源工具。

它的核心定位不仅仅是一个标准的 LSPosed/Xposed 模块，更是一个将 LSPosed 命名空间与系统级操作接口直接暴露给 AI Agent（如 RikkaHub 等）的 MCP（Model Context Protocol）服务端。

通过 MCP 协议，大语言模型可以在获得用户授权的前提下，直接调用系统接口与动态注入能力，帮助开发者与极客用户高效完成 Android 程序的动态分析、行为调试与自动化控制。

二、 核心架构与工作原理

1. LSPosed 命名空间桥接与 MCP 暴露

   • 本模块将 Xposed/LSPosed 的注入与 Hook 接口封装为标准 MCP 工具服务。

   • AI Agent 可在会话中直接读取运行时信息、动态编写并注入 Lua 脚本，实现无需频繁重新编译 APK 或重启系统的即时插桩调试。

2. 多维权限协同

   • 结合 Root 权限、无障碍服务（Accessibility Service）与悬浮窗权限，保障 MCP 服务在后台的稳定运行与跨进程通信。

三、 主要功能特性

1. 时停/进程冻结（探针功能）

   • 解决痛点： 针对开屏广告、短暂弹窗或一闪而过的界面，解决 AI Agent 分析界面时因生命周期过短导致无法抓取 UI 树的问题。

   • 后端自适应： 优先调用系统内核的 cgroup.freezer (v1/v2) 机制；若内核不支持，会自动退化至信号量（SIGSTOP/SIGCONT）控制。

   • 安全控制机制： 冻结操作仅支持由用户在悬浮窗或界面手动触发，Agent 仅可读取状态或请求解冻，防止因 AI 误操作引发系统卡死。同时配备独立 Root 看门狗机制，超时自动恢复进程状态。

2. 内置广告 SDK 数据库与规则提炼

   • 汇总了常见第三方广告 SDK 的组件结构与方法签名（如传感器注册、特定 Activity 启动等），为 AI 提供结构化的参考上下文，提升自动编写 Hook 规则的精准度。

3. 脚本与 Hook 持久化管理

   • Saved Scripts（按需脚本）： 支持存储并按需运行特定业务逻辑（如特定应用内的数据结构导出）。

   • Kept Hooks（持久化插桩）： 支持将调试成熟的 Lua Hook 规则注册为长期生效的插桩项，随应用启动自动加载。

四、 配置与使用流程

1. 模块端配置

1. 安装并激活本模块，授予 Root 权限。

2. 在 LSPosed 管理器中，勾选作用域：

   • 建议勾选 system_server 与 com.android.systemui（保障进程管理与系统级冻结守卫稳定）。

   • 勾选需要进行分析或注入的目标第三方应用。

3. 开启无障碍服务与悬浮窗权限，确保后台保活与操作提示正常显示。

2. Agent 端配置

1. 在支持 MCP 协议的 Agent（如 RikkaHub）中添加此 MCP 服务器地址，并配置对应的 Bearer 令牌认证。

2. 在会话中注入该 MCP 服务器的能力。

3. 配合截图或 UI 树 Dump 工具，由 AI 分析当前界面并生成相应的 Lua 插桩脚本。

五、 注意事项与风险提示

1. 安全与稳定风险

   • 本项目涉及系统底层 Root 权限与动态代码注入，AI 生成的代码将直接作用于目标进程。请在了解相关风险后使用，建议优先在测试机或虚拟机环境中尝试。

2. 救砖建议

   • 修改或 Hook 系统关键进程（如 system_server）存在导致设备卡屏或重启的风险，建议预先安装适用于 Magisk 的救砖模块（在Release页附带），以便在异常时自动挂起钩子。