Provides Android device automation capabilities, including ADB command execution, application management (launch/stop), UI automation (clicking elements, text input, screen swiping), screen capture, and UIAutomator2 service management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@UIAutomator2 MCP Servertake a screenshot of my Android device"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
UIAutomator2 MCP Server
基于FastMCP框架实现的UIAutomator2 MCP服务器,提供Android设备自动化控制能力。
功能特性
Android设备管理
ADB命令执行
应用包管理
屏幕截图
UI自动化操作
元素点击
文本输入
屏幕滑动
元素等待
页面滚动
应用管理
应用启动/停止
当前应用信息
UIAutomator2服务管理
Related MCP server: DroidMind
环境要求
Python 3.10+
ADB工具
Android设备或模拟器
安装
克隆项目
git clone https://github.com/yourusername/uiautomator2-mcp.git
cd uiautomator2-mcp安装依赖
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. 配置选项
你可以根据需要调整以下配置：
使用Python直接运行：
{
"mcpServers": {
"android": {
"command": "python",
"args": [
"/path/to/uiautomator2-mcp/src/server.py"
]
}
}
}使用虚拟环境：
{
"mcpServers": {
"android": {
"command": "/path/to/venv/bin/python",
"args": [
"/path/to/uiautomator2-mcp/src/server.py"
]
}
}
}添加环境变量：
{
"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": "登录"
})开发
安装开发依赖
pip install -e ".[dev]"运行测试
pytest贡献
欢迎提交Issue和Pull Request。
许可证
MIT License
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.