droidmind

DroidMind 是 AI 助手与 Android 设备之间的强大桥梁，通过实现模型上下文协议（MCP），允许 AI 模型经由 ADB 以安全、结构化的方式直接与 Android 设备交互。将其用于智能体编码工作流时，助手可将设备直接纳入构建与调试循环。

用途

帮助 AI 助手通过自然语言对 Android 设备进行控制、调试与系统分析。

主要能力

• 管理设备：通过 USB/TCP-IP 连接、列出设备、查看属性、重启。
• 分析系统：访问日志（logcat、ANR、崩溃、电池）、捕获 bug 报告、转储堆。
• 处理文件：浏览、读取、写入、推送、拉取、删除及管理设备文件/目录。
• 控制应用：安装、卸载、启动、停止、清除数据，检查应用详情（清单、权限、活动）。
• 自动化 UI：执行点击、滑动、文本输入和按键。
• 执行 Shell 命令：在注重安全的框架下运行 ADB shell 命令。
• 安全操作：具备命令验证、风险评估和净化处理。
• 无缝集成：可与任何兼容 MCP 的客户端（如 Claude、Cursor、Cline 等）连接。

使用方式

1. 环境要求：Python 3.13（暂不支持 3.14）、uv（Python 包管理器）、启用 USB 调试的 Android 设备、已安装 ADB 并加入系统 PATH。
2. IDE 快速集成（零安装，使用 uvx）：可在兼容 MCP 的 IDE（如 Cursor）中配置，直接从 GitHub 仓库运行 DroidMind，无需手动克隆或安装。将配置添加到 IDE 的 MCP 配置中（例如 Cursor 的 .cursor/mcp.json），IDE 会按需启动 DroidMind。
3. 手动安装后运行：
   • Stdio（用于终端直接交互或某些 IDE 设置）：droidmind --transport stdio
   • SSE（用于 Web UI 或 Claude Desktop 等 AI 助手）：droidmind --transport sse，通常启动服务器于 sse://localhost:4256/sse。
4. Docker：可参考 Docker 指南以容器方式运行，适合部署和隔离依赖。

适用场景

• 让 AI 助手列出所有已连接 Android 设备及其属性。
• 对 Pixel 截图。
• 在 emulator-5554 上安装 APK。
• 查看指定设备序列号的近期崩溃日志。
• 在当前屏幕点击“Next”按钮。

限制与安全

DroidMind 内置安全框架，包括命令验证与净化、风险评估分类、受保护路径操作和全面日志记录。高风险操作会被标记，关键操作默认被阻止。项目的详细能力可参见用户手册和 MCP 参考；安装细节参见安装指南。许可证为 Apache License。创建者为 Stefanie Jane。