TU

tanbro/uiautomator2-mcp-server

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

54 stars 12 forks 质量 91 趋势 33Apache-2.0

一台MCP(模型上下文协议)服务器,提供使用uiautomator2控制和交互Android设备的工具。

概览

参与本项目时请遵守我们的行为准则。 一个MCP服务器,提供使用uiautomator2控制Android设备的工具。 利用AI自动化你的安卓设备:截图、点击/滑动、管理应用、发送短信等。 : “在xxx应用上搜索猫咪视频,然后播放视频并切换到下一个视频” - ✅ 启动应用 → 点击搜索 → 输入关键词 → 执行搜索 → 点击结果 - > 切换到下一个视频 - 📱 - 一台服务器,多部手机 - 🔍 - 只导出你需要的UI元素 - 保存令牌并加快响应速度 - 🎛️ - 只向AI展示它需要的工具 - 减少幻觉,效果更好 - ⚡ - 立即运行uvx,无需安装 - 📦 - 捆绑成独立应用,PyInstaller或Nuitka可使用——无需Python运行时 - 🧰 - 点击、滑动、输入、应用、截图——一切所需 - 🧪 - 开箱即用AI驱动的UI测试框架 - 🔄 - 本地支持STDIO,远程支持HTTP - ⚙️ - 带自动发现功能的TOML/YAML/JSON配置-...

概述(AI 翻译)


  • 🇨🇳 中文说明

行为准则: 参与本项目时请遵守我们的行为准则。

一个MCP服务器,提供使用uiautomator2控制Android设备的工具。

利用人工智能自动化你的安卓设备:截图、点击/滑动、管理应用、发送短信等。

📺 演示

对话式安卓自动化

用户说:“在xxx应用上搜索猫咪视频,然后播放视频并切换到下一个视频”*

AI自动生成:

  • ✅ 启动应用 → 点击搜索 → 输入关键词 → 执行搜索 → 点击结果 - > 切换到下一个视频

用自然语言控制安卓设备,无需编码

详细示例:技能/抖音搜索


✨ 特色

  • 📱 多设备 - 一台服务器,多部手机
  • 🔍 XPath 过滤 - 只导出你需要的 UI 元素 — 保存令牌并加快响应速度
  • 🎛️ 工具过滤 - 只向AI展示它所需的工具——更少幻觉,效果更好
  • ⚡ 零设置 - 立即运行 uvx,无需安装
  • 📦 独立可执行文件 - 捆绑成带有 PyInstaller 或 Nuitka 的独立应用 — 无需 Python 运行时

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

uiautomator2-mcp-server



Code of Conduct: Please follow our Code of Conduct when participating in this project.

An MCP server that provides tools for controlling Android devices using uiautomator2.

Use AI to automate your Android device: take screenshots, tap/swipe, manage apps, send text, and more.

📺 Demo

Conversational Android Automation

User says: “Search cat videos on xxx App then play the video and swap to the next video”

AI automatically:

  • ✅ Launch app → Tap search → Enter keywords → Execute search → Tap result -> Swap to next video

Control Android devices with natural language, no coding required

Detailed example: skills/douyin-search


✨ Features

  • 📱 Multi-Device - One server, many phones
  • 🔍 XPath Filtering - Dump only the UI elements you need — save tokens and speed up responses
  • 🎛️ Tool Filtering - Show the AI only the tools it needs — fewer hallucinations, better results
  • ⚡ Zero Setup - Run with uvx immediately, no installation needed
  • 📦 Standalone Executable - Bundle into a standalone app with PyInstaller or Nuitka — no Python runtime required
  • 🧰 70+ Tools - Click, swipe, type, apps, screenshots — everything you need
  • 🧪 Built-in Testing - Includes AI-driven UI test framework out of the box
  • 🔄 Two Modes - STDIO for local, HTTP for remote
  • ⚙️ Config Files - TOML/YAML/JSON config with auto-discovery
  • 🔒 Clean Code - Type hints, linted, formatted — easy to extend
在 GitHub 查看完整 README

安装

uvx uiautomator2-mcp-server stdio
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "android": { "command": "uvx", "args": ["uiautomator2-mcp-server", "stdio"] } } }