UIAutomator2 MCP 服务器

基于FastMCP框架实现的UIAutomator2 MCP服务器提供了Android设备自动化控制能力。

功能

• Android 设备管理

  • ADB 命令执行
  • 应用程序包管理
  • 屏幕截图

• UI 自动化操作

  • 元素点击
  • 输入
  • 屏幕滑动
  • 元素等待
  • 页面滚动

• 应用程序管理

  • 应用程序启动/停止
  • 当前应用程序信息
  • UIAutomator2 服务管理

环境要求

• Python 3.10+
• ADB 工具
• Android 设备或模拟器

安装

1. 克隆项目

git clone https://github.com/yourusername/uiautomator2-mcp.git
cd uiautomator2-mcp

2. 安装依赖

pip install -e .

MCP 配置

1. 配置 mcp.json

在Claude Desktop的配置目录中创建或编辑mcp.json文件（通常位于~/.cursor/mcp.json或%APPDATA%\Cursor\mcp.json）：

{
  "mcpServers": {
    "android": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/uiautomator2-mcp",  // 替换为你的项目路径
        "run",
        "src/server.py"
      ]
    }
  }
}

配置说明：

• android：MCP服务器的唯一标识符
• command：运行Python的命令（这里使用UV，也可以使用Python）
• args：命令行参数
  • --directory：项目目录路径
  • run：运行UV的命令
  • src/server.py：服务器入口文件路径

2. 配置选项

根据需要可以调整以下配置：

1. 直接使用Python运行：

{
  "mcpServers": {
    "android": {
      "command": "python",
      "args": [
        "/path/to/uiautomator2-mcp/src/server.py"
      ]
    }
  }
}

2. 使用虚拟环境：

{
  "mcpServers": {
    "android": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "/path/to/uiautomator2-mcp/src/server.py"
      ]
    }
  }
}

3. 添加环境变量：

{
  "mcpServers": {
    "android": {
      "command": "python",
      "args": [
        "/path/to/uiautomator2-mcp/src/server.py"
      ],
      "env": {
        "PYTHONPATH": "/path/to/uiautomator2-mcp",
        "ANDROID_HOME": "/path/to/android-sdk"
      }
    }
  }
}

3. 多服务器配置

可以在同一个配置文件中定义多个MCP服务器：

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

使用工具

配置完成后，可以直接在Claude中使用所有可用工具：

# 初始化UIAutomator2
await mcp.call_tool("mcp_android_init_uiautomator2", {})

# 启动应用
await mcp.call_tool("mcp_android_start_app", {
    "package_name": "com.example.app"
})

# 点击元素
await mcp.call_tool("mcp_android_click_element", {
    "text": "登录"
})

开发

1. 安装和开发依赖

pip install -e ".[dev]"

2. 运行测试

pytest

贡献

欢迎提交Issue和Pull Requests。

许可证

MIT 许可证