DroidAgentKit

本地运行的 MCP 服务器，为 AI 编码代理提供结构化的 Android 工具：Gradle 任务、adb、logcat、lint、崩溃排查、Perfetto 追踪和视觉差异。

可以做什么

检查 Android 项目并运行白名单内的 Gradle 任务、测试和构建，默认核心组还提供构建诊断和 APK 体积分析。管理设备：列出设备、安装和启动应用、抓取 logcat 和截图、生成无障碍快照、查找 UI 元素。运行 lint、带 R8 反混淆的崩溃排查、依赖检查和构建性能报告。可选工具组增加设备诊断、受限设备控制（按标签点击、流程录制）、Perfetto 追踪分析、像素差异视觉回归、只读应用存储检查和实验性模拟器网络抓包。

适用场景

当代理处理 Android 项目，并希望通过结构化工具而非原始 shell 来构建、测试、调试和性能分析时使用。适合崩溃排查、logcat 分析、APK 体积问题和 Compose 视觉回归，不适用于 iOS。

运行要求

通过 npx 运行 npm 启动器包启动的本地进程，安装时需要 Node 18+。需要 PATH、JAVA_HOME 或 DROIDAGENT_JAVA 指定的 JDK 17+，否则会下载并缓存经校验的 Temurin JRE。设备工具可选需要 adb/platform-tools，并设置 ANDROID_HOME 或配置 adbPath。项目配置文件用于调整白名单和能力。