AutoBot MCP

这是一个基于AutoBot API的MCP（Model Context Protocol）实现，用于远程控制和自动化Android设备。

功能特点

• 获取设备上所有已安装的应用包名

• 执行ADB shell命令

• 获取当前UI布局信息

• 获取设备截图

• 获取指定包名的活动意图

• 点击和长按屏幕指定位置

• 滑动操作

• 文本输入

• 按键模拟

• 应用启动和停止

• 获取设备和屏幕信息

开发环境要求

• Python >= 3.12

• uv Python 包管理器

• Android 设备运行 AutoBot HTTP 服务

安装

1. 克隆仓库：

2. 使用 uv 安装依赖：

配置

1. 在项目根目录创建config.yaml文件（从示例文件复制）：

2. 修改config.yaml，填入你的设备信息：

运行

使用 uv 运行 MCP 服务器：

或者在激活虚拟环境后直接运行：

测试

安装依赖后，可以测试 MCP 工具是否正常工作：

可用工具函数

基本操作

• get_packages() - 获取设备上所有已安装的应用包名

• execute_adb_shell_command(command) - 执行ADB shell命令

• get_uilayout() - 获取当前UI布局信息

• get_screenshot() - 获取设备截图

• get_package_action_intents(package_name) - 获取指定包名的活动意图

屏幕操作

• click(x, y) - 点击屏幕指定位置

• long_click(x, y) - 长按屏幕指定位置

• swipe(x1, y1, x2, y2, duration) - 从一点滑动到另一点

• input_text(text) - 输入文本

• press_key(key_code) - 模拟按键

应用管理

• start_app(package_name) - 启动应用

• stop_app(package_name) - 停止应用

设备信息

• get_device_info() - 获取设备详细信息

• get_screen_info() - 获取屏幕信息

相关文档

• API 文档位于 docs 目录

• 项目开发指南请参考 CLAUDE.md

许可证

MIT