droidmind
byhyperb1iss· 3 MCP servers
Control Android devices with AI through the Model Context Protocol
How to install droidmind?
hyperb1iss/droidmind
$git clone https://github.com/hyperb1iss/droidmindInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install droidmind by running `git clone https://github.com/hyperb1iss/droidmind`, then use it for the current task and follow its documentation at https://github.com/hyperb1iss/droidmind.
README.md
| 1 | <div align="center"> |
| 2 | |
| 3 | # 🤖 DroidMind 🧠 |
| 4 | |
| 5 | <img src="docs/assets/images/logo_neon_glow_icon.png" alt="DroidMind Logo" width="180" /> |
| 6 | |
| 7 | [](https://www.python.org/downloads/) |
| 8 | [](LICENSE) |
| 9 | [](docs/plan.md) |
| 10 | [](https://github.com/astral-sh/ruff) |
| 11 | [](https://github.com/microsoft/pyright) |
| 12 | [](https://modelcontextprotocol.io/) |
| 13 | [](https://www.android.com/) |
| 14 | [](https://hyperb1iss.github.io/droidmind/) |
| 15 | |
| 16 | **Control Android devices with AI through the Model Context Protocol** |
| 17 | |
| 18 | </div> |
| 19 | |
| 20 | DroidMind is a powerful bridge between AI assistants and Android devices, enabling control, debugging, and system analysis through natural language. By implementing the Model Context Protocol (MCP), DroidMind allows AI models to directly interact with Android devices via ADB in a secure, structured way. When used as part of an agentic coding workflow, DroidMind can enable your assistant to build and debug with your device directly in the loop. |
| 21 | |
| 22 | ## 💫 Core Features |
| 23 | |
| 24 | DroidMind empowers AI assistants to: |
| 25 | |
| 26 | - 📱 **Manage Devices**: Connect via USB/TCP-IP, list devices, view properties, and reboot. |
| 27 | - 📊 **Analyze Systems**: Access logs (logcat, ANR, crash, battery), capture bug reports, and dump heap. |
| 28 | - 📂 **Handle Files**: Browse, read, write, push, pull, delete, and manage device files/directories. |
| 29 | - 📦 **Control Apps**: Install, uninstall, start, stop, clear data, and inspect app details (manifest, permissions, activities). |
| 30 | - 🖼️ **Automate UI**: Perform taps, swipes, text input, and key presses. |
| 31 | - 🐚 **Execute Shell Commands**: Run ADB shell commands with a security-conscious framework. |
| 32 | - 🔒 **Operate Securely**: Benefit from command validation, risk assessment, and sanitization. |
| 33 | - 💬 **Integrate Seamlessly**: Connect with any MCP-compatible client (Claude, Cursor, Cline, etc.). |
| 34 | |
| 35 | For a detailed list of capabilities, see the **[User Manual](docs/user_manual/index.md)** and **[MCP Reference](docs/mcp-reference.md)**. |
| 36 | |
| 37 | ## 🚀 Getting Started |
| 38 | |
| 39 | ### Quickstart for IDEs (Zero Install with `uvx`) |
| 40 | |
| 41 | For the fastest way to integrate DroidMind with an MCP-compatible IDE (like Cursor), you can configure it to run DroidMind directly from its GitHub repository using `uvx`. This method **does not require you to manually clone or install DroidMind first**. |
| 42 | |
| 43 | Add the following to your IDE's MCP configuration (e.g., `.cursor/mcp.json` for Cursor): |
| 44 | |
| 45 | ```json |
| 46 | { |
| 47 | "mcpServers": { |
| 48 | "droidmind": { |
| 49 | "command": "uvx", |
| 50 | "args": [ |
| 51 | "--from", |
| 52 | "git+https://github.com/hyperb1iss/droidmind", |
| 53 | "droidmind", |
| 54 | "--transport", |
| 55 | "stdio" // The default and preferred mode for most IDE integrations |
| 56 | ] |
| 57 | } |
| 58 | } |
| 59 | } |
| 60 | ``` |
| 61 | |
| 62 | Your IDE will be configured to launch DroidMind on demand. Full instructions for this setup are in the **[Quick Start Guide](docs/quickstart.md#1-configure-your-ide-to-run-droidmind-via-uvx)**. |
| 63 | |
| 64 | ### Prerequisites |
| 65 | |
| 66 | - Python 3.13 (3.14 not yet supported) |
| 67 | - `uv` (Python package manager) |
| 68 | - Android device with USB debugging enabled |
| 69 | - ADB (Android Debug Bridge) installed and in your system's PATH |
| 70 | |
| 71 | ### Installation |
| 72 | |
| 73 | For detailed |
Related
6 picksType
- agent-deviceLet AI agents inspect, control, and debug real iOS, Android, desktop, and TV appsJul 2026
- xcodebuildmcpXcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.Jul 2026
- mobile-mcpMCP server for iOS and Android Mobile Development, Automation and TestingJul 2026
- android-mcp-serverAn MCP server for android automationMay 2025
- android-mcpLightweight MCP Server for Android Operating SystemJul 2026
- mobile-mcpA MCP server to control your mobile devicesApr 2025
