Android MCP 服务器

一个 MCP (模型上下文协议) 服务器，通过 ADB (Android 调试桥) 提供对 Android 设备的程序化控制。该服务器公开了各种 Android 设备管理功能，这些功能可以被 MCP 客户端访问，例如 Claude desktop 和代码编辑器 (例如 Cursor)。

功能

• 🔧 ADB 命令执行
• 📸 设备屏幕截图捕获
• 🎯 UI 布局分析
• 📱 设备包管理

前提条件

• Python 3.x
• ADB (Android 调试桥) 已安装并配置
• Android 设备或模拟器 (未经测试)

安装

1. 克隆存储库：

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

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

uv python install 3.11
uv sync

配置

服务器使用一个简单的 YAML 配置文件 (config.yaml) 来指定目标 Android 设备。

自定义配置

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

touch config.yaml

2. 配置您的设备：

device:
  name: "google-pixel-7-pro:5555" # 您设备标识符，来自 '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 为您克隆此存储库的绝对路径

可用工具

服务器公开了以下工具：

def get_packages() -> str:
    """
    获取设备上所有已安装的软件包。
    Returns:
        str: 设备上所有已安装软件包的字符串列表
    """

def execute_adb_command(command: str) -> str:
    """
    执行 ADB 命令并返回输出。
    Args:
        command (str): 要执行的 ADB 命令
    Returns:
        str: ADB 命令的输出
    """

def get_uilayout() -> str:
    """
    检索有关当前 UI 中可点击元素的信息。
    返回一个格式化的字符串，其中包含有关每个可点击元素的详细信息，
    包括它们的文本、内容描述、边界和中心坐标。

    Returns:
        str: 包含其属性的可点击元素的格式化列表
    """

def get_screenshot() -> Image:
    """
    拍摄设备的屏幕截图并返回。
    Returns:
        Image: 屏幕截图
    """

def get_package_action_intents(package_name: str) -> list[str]:
    """
    从 Activity Resolver Table 中获取包的所有非数据操作
    Args:
        package_name (str): 要获取操作的包的名称
    Returns:
        list[str]: 来自 Activity Resolver 的所有非数据操作的列表
        包的表
    """

贡献

欢迎贡献！

鸣谢

• 构建于 模型上下文协议 (MCP)