AI时代来临,为支持开发者通过AI Agent在HarmonyOS设备上执行测试,Hypium提供了设备测试MCP工具,通过标准MCP协议,让AI模型能够调用 Hypium 能力对HarmonyOS设备进行智能自动化操作。
MCP 工具列表(仅列出MCP工具,全量接口可参考使用指南):
模块 | 工具名称 | 说明 |
|---|---|---|
基础操作(basic) | start_app | 启动指定应用(支持包名或应用名称) |
stop_app | 停止指定应用 | |
double_click | 在指定坐标执行双击操作 | |
屏幕控制(screen) | unlock_screen | 解锁设备屏幕 |
screen_on | 打开设备屏幕 | |
rotate_screen | 旋转屏幕方向 | |
应用管理(app_manager) | install_app | 安装应用程序 |
uninstall_app | 卸载应用程序 | |
get_current_app | 获取当前运行应用的包名 | |
Toast 监听(toast) | start_listen_toast | 开始监听 Toast 消息 |
get_toast | 获取最新 Toast 消息 | |
通用手势操作(general_gesture) | pinch_in | 双指捏合缩小操作 |
pinch_out | 双指张开放大操作 | |
rotate_gesture | 双指旋转手势,支持指定角度和方向 | |
系统手势(system_gesture) | open_notification_center | 打开系统通知中心 |
enter_recent_task | 进入系统最近任务界面 | |
drag_to_xiaoyi | 将元素拖拽给小艺智能助手 | |
观察工具(observation) | screenshot | 获取屏幕截图(保存到指定路径,仅支持jpg格式) |
layout | 获取当前页面布局结构 | |
find_elements | 通过属性查找页面元素 | |
数据采集(plugins) | start_data_collect | 开始数据采集 |
stop_data_collect | 结束数据采集 | |
generate_report | 生成测试报告 | |
应用管理扩展(app_manager_ext) | start_app_by_deep_link | 通过 Deep Link 启动应用,支持额外指定包名和ability名称 |
应用管理扩展(app_manager_ext) | write_clipboard | 写入字符串到剪切板 |
read_clipboard | 读取剪切板内容 | |
clear_clipboard | 清空剪切板内容 | |
剪贴板操作(clipboard) | write_clipboard | 写入字符串到剪贴板 |
read_clipboard | 读取剪贴板内容 | |
clear_clipboard | 清空剪贴板内容 | |
系统设置(settings) | set_view_mode | 设置系统视图模式(深色/浅色模式) |
Shell 命令(shell) | execute_shell_command | 在设备上执行 Shell 命令 |
pull_file | 从设备拉取文件到本地 | |
push_file | 将本地文件推送到设备 |