用途：通过 ADB 让 AI 助手“看见、操作并调试” Android 应用，适用于 Claude Code 等支持 MCP 的客户端，可用于缺陷复现与文档记录、登录等界面流程验证、APK 安装后的冒烟测试以及元素交互自动化。
主要能力：提供 25 个工具，覆盖设备管理（列出设备、启动模拟器、获取设备信息）、截图（基于 Sharp 压缩，最长边最大 1280px）、UI 树检查（读取元素层级及其 bounds、文本、resource-id、状态）、触摸自动化（tap、swipe、scroll、type text、按硬件键）、元素定位（按 resource-id、text 或 content-desc 查找并点击）、应用生命周期（安装 APK、启动应用、查看当前 Activity）、logcat 集成（按包名、日志级别或时间戳过滤）以及组合动作（如 tap_and_wait 将点击、等待稳定与读取 UI 树合并为一次往返）。另有持久化 ADB shell、设备信息缓存与多设备按 ID 定向支持。
使用方式：需先安装 Android SDK 及 platform-tools（ADB）和 emulator，并准备运行中的模拟器或已连接设备。服务器会在 macOS 的 ~/Library/Android/sdk 或通过 ANDROID_HOME 自动发现 SDK；若 SDK 在其他位置，需在 MCP 配置中设置 ANDROID_HOME。可全局注册该服务器，也可用 --scope project 限制在当前项目；亦可写入 Claude Desktop 配置、VS Code 的 .vscode/settings.json、Cursor 的 ~/.cursor/mcp.json、Windsurf 的 ~/.codeium/windsurf/mcp_config.json，或项目内的 .mcp.json。服务器通过 stdio 按 Model Context Protocol 通信；所有设备交互均经 ADB，应用无需任何修改。
限制：资料未提供具体命令与代码示例；使用前提为具备 Android SDK、ADB 与可用模拟器或真机；截图会压缩，最长边上限 1280px；仓库以 MIT 许可发布。
