{"name":"android-mcp-server: Programmatic Android Device Control via ADB","description":"The android-mcp-server is a Python-based Model Context Protocol (MCP) server designed to offer programmatic control over Android devices using ADB. It enables advanced device management capabilities, including screenshot capture, UI layout analysis, and package management. This server integrates seamlessly with MCP clients like Claude Desktop, providing a powerful tool for developers and automation enthusiasts.","github":"https://github.com/minhalvp/android-mcp-server","url":"https://osrepos.com/repo/minhalvp-android-mcp-server","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/minhalvp-android-mcp-server","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/minhalvp-android-mcp-server.md","json":"https://osrepos.com/repo/minhalvp-android-mcp-server.json","topics":["Python","Android","ADB","MCP","Automation","Device Control","Server","Development Tools"],"keywords":["Python","Android","ADB","MCP","Automation","Device Control","Server","Development Tools"],"stars":null,"summary":"The android-mcp-server is a Python-based Model Context Protocol (MCP) server designed to offer programmatic control over Android devices using ADB. It enables advanced device management capabilities, including screenshot capture, UI layout analysis, and package management. This server integrates seamlessly with MCP clients like Claude Desktop, providing a powerful tool for developers and automation enthusiasts.","content":"## Introduction\nThe `android-mcp-server` project provides a robust Model Context Protocol (MCP) server that facilitates programmatic control over Android devices through the Android Debug Bridge (ADB). This server exposes a range of Android device management capabilities, making it an invaluable tool for automation, testing, and development workflows. It is designed to be accessed by MCP clients, such as Claude Desktop and various code editors.\n\nKey features include:\n*   ADB Command Execution\n*   Device Screenshot Capture\n*   UI Layout Analysis\n*   Device Package Management\n\n## Installation\nTo get started with `android-mcp-server`, follow these steps:\n\n### 1. Prerequisites:\n*   Python 3.x\n*   ADB (Android Debug Bridge) installed and configured on your system.\n*   An Android device or emulator.\n\n### 2. Clone the repository:\nbash\ngit clone https://github.com/minhalvp/android-mcp-server.git\ncd android-mcp-server\n\n\n### 3. Install dependencies:\nThis project uses `uv` for project management. If you don't have `uv`, refer to its [installation guide](https://docs.astral.sh/uv/getting-started/installation/) (opens in a new tab).\nbash\nuv python install 3.11\nuv sync\n\n\n## Examples\nThe `android-mcp-server` is designed to be used with an MCP client. Here's how to configure it with Claude Desktop and an overview of the available tools.\n\n### Configuration with Claude Desktop:\n1.  Locate your Claude Desktop configuration file:\n    *   Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n    *   macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n2.  Add the Android MCP server configuration to the `mcpServers` section:\n\n{\n  \"mcpServers\": {\n    \"android\": {\n      \"command\": \"path/to/uv\",\n      \"args\": [\"--directory\", \"path/to/android-mcp-server\", \"run\", \"server.py\"]\n    }\n  }\n}\n\nRemember to replace `path/to/uv` with the actual path to your `uv` executable and `path/to/android-mcp-server` with the absolute path where you cloned the repository.\n\n### Available Tools:\nThe server exposes several powerful tools for interacting with Android devices:\n\n*   `get_packages()`: Get all installed packages on the device.\n*   `execute_adb_command(command: str)`: Executes any ADB command and returns its output.\n*   `get_uilayout()`: Retrieves information about clickable elements in the current UI.\n*   `get_screenshot()`: Takes a screenshot of the device and returns it.\n*   `get_package_action_intents(package_name: str)`: Get all non-data actions from Activity Resolver Table for a package.\n\n## Why Use\nThe `android-mcp-server` offers a streamlined way to integrate Android device control into your development and automation workflows. By leveraging the Model Context Protocol, it allows AI agents and other clients to interact with Android devices programmatically, enabling tasks such as automated testing, UI analysis, and rapid prototyping. Its Python foundation and clear ADB integration make it accessible for developers looking to extend their control over Android environments.\n\n## Links\n*   **GitHub Repository:** [minhalvp/android-mcp-server](https://github.com/minhalvp/android-mcp-server) (opens in a new tab)\n*   **Model Context Protocol (MCP):** [Introduction](https://modelcontextprotocol.io/introduction) (opens in a new tab)\n*   **uv Installation:** [Getting Started](https://docs.astral.sh/uv/getting-started/installation/) (opens in a new tab)","metrics":{"detailViews":9,"githubClicks":15},"dates":{"published":null,"modified":"2026-02-07T00:00:37.000Z"}}