项目简介

Ultimate Android MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许通过 ADB (Android Debug Bridge) 与连接的 Android 设备进行交互。该项目将各种 Android 操作封装成一系列可通过 MCP 协议调用的工具，使得大型语言模型 (LLM) 客户端能够理解并自动化控制 Android 设备。

主要功能点

应用管理: 列出已安装应用，启动、安装、卸载特定应用，检查应用是否安装。
输入模拟: 模拟屏幕点击、滑动、文本输入、按键事件（如返回、主页），检查虚拟键盘状态。
设备信息: 获取设备的序列号、属性、电池电量、屏幕尺寸和密度。
系统与性能: 获取CPU核心数、CPU负载百分比，获取进程ID，列出顶部Activity。
文件管理: 从设备拉取文件到本地，或推送本地文件到设备。
UI 交互: 获取屏幕上可见的包含文本或内容描述的UI节点，获取当前聚焦的UI节点。
高级操作: 执行任意 ADB shell 命令并获取输出。

安装步骤

克隆仓库: 打开终端，执行以下命令克隆项目到本地：

git clone https://github.com/oddlyspaced/ultimate-android-mcp.git android-mcp
cd android-mcp

安装依赖: 确保你的系统安装了 Python 3 和 ADB (Android Debug Bridge)，并且 'adb' 命令可以在终端中直接运行。然后安装项目所需的 Python 库：

# 推荐使用 uv
uv sync
# 或者使用 pip
# pip install pure-python-adb mcp

配置设备: 编辑项目根目录下的 'config.py' 文件，根据你的实际情况配置 ADB 服务器地址、端口以及你想要连接的 Android 设备的序列号（如果未指定序列号，将默认连接第一个可用的设备）。
连接检查: 运行配置检查脚本，确保设备正确连接：
```
python doctor.py
```
如果一切正常，你应该会看到设备连接成功的提示。

服务器配置

此 MCP 服务器是为 MCP 客户端（如 Claude Desktop）提供服务的。你需要配置你的 MCP 客户端，告诉它如何启动并连接到这个服务器。配置通常以 JSON 格式提供，指定启动服务器进程的命令和参数。以下是配置 MCP 客户端连接此服务器的示例（请根据你实际的项目路径进行修改）：

{
  "mcpServers": {
    "Android MCP": {             // 服务器名称，客户端将以此名称显示
      "command": "python",       // 用于启动服务器进程的命令，这里是python解释器
      "args": [
        "/你的/项目/路径/android-mcp/server.py" // 启动服务器脚本的完整路径，请替换为你实际的路径
      ]
    }
  }
}

将上述配置添加到你的 MCP 客户端的配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json'），并替换 '/你的/项目/路径/' 为你克隆 'android-mcp' 仓库的实际文件夹路径。

基本使用方法

配置完成后，启动你的 MCP 客户端。客户端会自动检测并启动 Ultimate Android MCP 服务器，并通过标准输入/输出 (stdio) 与其建立连接。MCP 客户端会将服务器公开的工具提供给 LLM 使用。你现在可以通过客户端向 LLM 发送指令，让 LLM 调用这些工具来与你的 Android 设备进行自动化交互。例如，你可以尝试让 LLM 执行“在连接的 Android 设备上打开设置应用”或“查找屏幕上的特定按钮并点击它”等任务。

关键词

信息