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

Android MCP 服务器

MCP（模型上下文协议）服务器，通过 ADB（Android 调试桥）提供对 Android 设备的编程控制。该服务器提供各种 Android 设备管理功能，可供 MCP 客户端（例如Claude 桌面和代码编辑器，例如Cursor ）访问。

特征

  • 🔧 ADB 命令执行

  • 📸 设备截图

  • 🎯 UI 布局分析

  • 📱 设备包管理

先决条件

  • Python 3.x

  • ADB（Android Debug Bridge）安装和配置

  • Android 设备或模拟器（未测试）

安装

  1. 克隆存储库：

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

  1. 安装依赖项：本项目通过各种安装方法使用uv进行项目管理。

uv python install 3.11 uv sync

配置

服务器使用简单的 YAML 配置文件（ config.yaml ）来指定目标 Android 设备

自定义配置

  1. 创建一个新的配置文件：

touch config.yaml

  1. 配置您的设备：

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

用法

使用此服务器需要 MCP 客户端。Claude Desktop 应用就是一个 MCP 客户端的示例。要将此服务器与 Claude Desktop 配合使用，请执行以下操作：

  1. 找到您的 Claude Desktop 配置文件：

    • Windows： %APPDATA%\Claude\claude_desktop_config.json

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

  2. 将 Android MCP 服务器配置添加到mcpServers部分：

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

代替：

  • path/to/uv替换为uv可执行文件的实际路径

  • path/to/android-mcp-server为您克隆此存储库的绝对路径

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

可用工具

该服务器公开以下工具：

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 """

贡献

欢迎投稿！

致谢

This server cannot be installed

-
security - not tested
A
license - permissive license
-
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.

该服务器可通过 ADB 对 Android 设备进行编程控制，提供屏幕截图、UI 布局分析和包管理等功能，可供 Claude Desktop 等 MCP 客户端访问。

  1. 特征
    1. 先决条件
      1. 安装
        1. 配置
          1. 自定义配置
        2. 用法
          1. 可用工具
        3. 贡献
          1. 致谢

            Related Resources

            Related MCP Servers

            • Android ADB MCP Server

              landicefu
              -
              security
              A
              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
              F
              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
              A
              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
              A
              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