🤖 DroidMind🧠
通过模型上下文协议使用AI控制Android设备
DroidMind是AI助手和Android设备之间的强大桥梁，通过自然语言实现控制、调试和系统分析。通过实施模型上下文协议（MCP），DroidMind允许AI模型以安全、结构化的方式通过ADB直接与Android设备交互。当用作代理编码工作流程的一部分时，DroidMind可以使您的助手直接在循环中构建和调试您的设备。
💫 核心功能
DroidMind使AI助手能够：
- 📱 管理设备：通过USB/TCP-IP连接，列出设备，查看属性，然后重新启动。
- 📊 分析系统：访问日志（logcat、ANR、崩溃、电池）、捕获错误报告和转储堆。
- 📂 处理文件：浏览、读取、写入、推送、拉取、删除和管理设备文件/目录。
- 📦 控制应用程序：安装、卸载、启动、停止、清除数据和检查应用程序详细信息（清单、权限、活动）。
- 🖼️ 自动化用户界面：执行轻击、滑动、文本输入和按键。
- 🐚 执行Shell命令：使用安全意识框架运行ADB shell命令。
- 🔒 安全操作：受益于命令验证、风险评估和消毒。
- 💬 无缝集成：连接任何兼容MCP的客户端（Claude、Cursor、Cline等）。
🚀 入门指南
IDE快速入门（零安装 uvx)
为了最快地将DroidMind与MCP兼容的IDE（如Cursor）集成，您可以使用以下命令将其配置为直接从其GitHub存储库运行DroidWind uvx.这种方法 不需要您先手动克隆或安装DroidMind.
将以下内容添加到IDE的MCP配置中（例如。， .cursor/mcp.json 光标）：
{
"mcpServers": {
"droidmind": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/hyperb1iss/droidmind",
"droidmind",
"--transport",
"stdio" // The default and preferred mode for most IDE integrations
]
}
}
}您的IDE将被配置为按需启动DroidMind。有关此设置的完整说明，请参阅 快速入门指南.
先决条件
- Python 3.13（尚未支持3.14）
uv（Python包管理器）- 启用USB调试的Android设备
- ADB（Android调试桥）已安装并位于系统的PATH中
安装
有关设置DroidMind的详细说明，包括与的快速IDE集成 uvx （在快速入门中介绍），从源代码手动安装，或使用Docker，请参阅我们的综合 安装指南.
运行DroidMind
如何运行DroidMind取决于您的设置：
- IDE集成（通过
uvx)：您的IDE会按照MCP设置中的配置自动管理正在运行的DroidMind（例如。，mcp.json).看 快速入门指南. - 手动安装：从源代码安装后，您可以直接运行DroidMind。
- Stdio（用于直接终端交互或某些IDE设置）：
droidmind --transport stdio- SSE（适用于web UI或Claude Desktop等AI助手）：
droidmind --transport sse这通常在以下位置启动服务器 sse://localhost:4256/sse.
- 码头工人：请参阅 用于在容器中运行DroidMind的命令。
参见 安装指南 有关在不同环境中运行DroidMind的更多详细信息。
🐳 使用Docker运行
DroidMind也可以使用Docker在一致的容器化环境中运行。这对于部署和隔离依赖关系特别有用。
有关构建Docker镜像和在容器中运行DroidMind的全面说明，请使用 stdio 或 SSE 运输，包括ADB设备访问的注意事项，请参阅我们的 ****.
🔮 AI助手查询示例
通过连接到DroidMind的AI助手，您可以发出以下请求：
- “列出所有连接的Android设备并显示其属性。”
- “给我的Pixel截图。”
- “在上安装此APK
emulator-5554." - “显示最近的崩溃日志
your_device_serial." - “点击当前屏幕上的“下一步”按钮
emulator-5554."
如需更多灵感，请查看我们的 查询和工作流示例 在用户手册中。
🔒 安全
DroidMind集成了一个安全框架来保护您的设备：
- 命令验证和消毒
- 风险评估分类
- 受保护的路径操作
- 综合录井
高风险操作被标记，关键操作默认被阻止。在我们的 安全考虑 章。
💻 发展
DroidMind使用 uv 用于依赖关系管理和开发工作流。
# Install/update dependencies (creates/updates `.venv`)
uv sync --all-groups
# Run tests
uv run pytest
# Run linting
uv run ruff check .
# Run type checking
uv run pyright🤝 贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库。
- 创建功能分支(
git checkout -b feature/amazing-feature). - 使用设置您的开发环境
uv. - 进行更改。
- 运行测试、linting和类型检查。
- 提交您的更改(
git commit -m 'Add some amazing feature'). - 推到分支(
git push origin feature/amazing-feature). - 打开拉取请求。
📝 许可证
此项目根据Apache许可证获得许可-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
由...创建 斯蒂芬妮·简🌠
如果你觉得DroidMind有用， 给我买一个怪物紫外线⚡️
