Skip to main content
Glama
enesjakozh

Android MCP Server

by minhalvp
GitHub
Python
Apache 2.0
553
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor MCP de Android

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona control programático sobre dispositivos Android a través de ADB (Puente de Depuración de Android). Este servidor expone diversas funciones de gestión de dispositivos Android a las que pueden acceder clientes MCP, como el escritorio Claude y editores de código (p. ej., Cursor ).

Características

  • Ejecución del comando ADB

  • Captura de pantalla del dispositivo

  • 🎯 Análisis del diseño de la interfaz de usuario

  • 📱 Gestión de paquetes de dispositivos

Prerrequisitos

  • Python 3.x

  • ADB (Android Debug Bridge) instalado y configurado

  • Dispositivo o emulador Android (no probado)

Instalación

  1. Clonar el repositorio:

git clone https://github.com/minhalvp/android-mcp-server.git cd android-mcp-server

  1. Instalar dependencias: Este proyecto utiliza uv para la gestión de proyectos a través de varios métodos de instalación .

uv python install 3.11 uv sync

Configuración

El servidor utiliza un archivo de configuración YAML simple ( config.yaml ) para especificar el dispositivo Android de destino

Personalización de la configuración

  1. Crear un nuevo archivo de configuración:

touch config.yaml

  1. Configura tu dispositivo:

device: name: "google-pixel-7-pro:5555" # Your device identifier from 'adb devices'

Uso

Se necesita un cliente MCP para usar este servidor. La aplicación Claude Desktop es un ejemplo de cliente MCP. Para usar este servidor con Claude Desktop:

  1. Localice el archivo de configuración de Claude Desktop:

    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  2. Agregue la configuración del servidor MCP de Android a la sección mcpServers :

{ "mcpServers": { "android": { "command": "path/to/uv", "args": ["--directory", "path/to/android-mcp-server", "run", "server.py"] } } }

Reemplazar:

  • path/to/uv con la ruta real a su ejecutable uv

  • path/to/android-mcp-server con la ruta absoluta a donde clonó este repositorio

https://github.com/user-attachments/assets/c45bbc17-f698-43e7-85b4-f1b39b8326a8

Herramientas disponibles

El servidor expone las siguientes herramientas:

def get_packages() -> str: """ Get all installed packages on the device. Returns: str: A list of all installed packages on the device as a string """
def execute_adb_command(command: str) -> str: """ Executes an ADB command and returns the output. Args: command (str): The ADB command to execute Returns: str: The output of the ADB command """
def get_uilayout() -> str: """ Retrieves information about clickable elements in the current UI. Returns a formatted string containing details about each clickable element, including their text, content description, bounds, and center coordinates. Returns: str: A formatted list of clickable elements with their properties """
def get_screenshot() -> Image: """ Takes a screenshot of the device and returns it. Returns: Image: the screenshot """
def get_package_action_intents(package_name: str) -> list[str]: """ Get all non-data actions from Activity Resolver Table for a package Args: package_name (str): The name of the package to get actions for Returns: list[str]: A list of all non-data actions from the Activity Resolver Table for the package """

Contribuyendo

¡Las contribuciones son bienvenidas!

Expresiones de gratitud

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Un servidor que permite el control programático de dispositivos Android a través de ADB, brindando capacidades como captura de captura de pantalla, análisis de diseño de UI y administración de paquetes a los que pueden acceder clientes MCP como Claude Desktop.

  1. Características
    1. Prerrequisitos
      1. Instalación
        1. Configuración
          1. Personalización de la configuración
        2. Uso
          1. Herramientas disponibles
        3. Contribuyendo
          1. Expresiones de gratitud

            Related Resources

            Related MCP Servers

            • Android ADB MCP Server

              landicefu
              -
              security
              -
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants to interact with Android devices through ADB, allowing for automated device management, app installation, file transfers, and screenshot capture.
              Last updated -
              53
              27
              ISC License
              • Linux
              • Apple

            • UIAutomator2 MCP Server

              GitDzreal93
              -
              security
              -
              license
              -
              quality
              A FastMCP framework-based server providing Android device automation control capabilities, enabling UI interactions, device management, and application control through natural language.
              Last updated -
              10
              • Linux
              • Apple

            • Apktool MCP Server

              zinja-coder
              A
              security
              -
              license
              A
              quality
              An MCP server that integrates with Apktool to provide live reverse engineering support for Android applications using Claude and other LLMs through the Model Context Protocol.
              Last updated -
              13
              220
              Apache 2.0
              • Linux

            • ADB MCP Server

              richard0913
              A
              security
              -
              license
              A
              quality
              A Model Context Protocol server that provides Android Debug Bridge functionality for automating Android devices, enabling remote device management, screen operations, app management, file operations, and shell command execution.
              Last updated -
              20
              3
              1
              MIT License

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/minhalvp/android-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server