产品
测试服务
解决方案
客户案例
腾讯端服务
行业资讯
关于我们
咨询方案
文档
进入工作站
登录
免费注册
Model Context Protocol

UBox MCP Server

优测PAAS云真机平台为 AI Agent 提供的设备操作能力集成方案,通过标准化协议让 AI Agent 直接调用设备操作能力

快速接入 ↓查看工具列表集成指南

核心特性

基于 MCP 标准协议,为 AI Agent 提供强大的云真机设备操作能力

⚡

标准化协议

遵循 MCP 协议标准,支持 Streamable HTTP 与 SSE 两种传输模式,易于集成

🚀

实时交互

支持 AI Agent 与设备的实时双向交互,毫秒级响应

🎮

设备抽象

提供统一的设备操作接口,屏蔽 Android / iOS / HarmonyOS 底层差异

📱

多设备管理

支持同时连接和管理多台设备,并行执行任务

🖥

多平台支持

支持 Android、iOS、HarmonyOS、HarmonyOS NEXT 四大平台

应用场景

覆盖 AI Agent 设备交互的多种典型场景

01

AI Agent 训练

Agent 在真实设备上进行训练和推理,获取真实环境反馈

02

自动化测试

AI 自动生成测试用例并在真机上执行,验证应用行为

03

RPA 自动化

AI 自动执行复杂业务流程,替代重复性人工操作

04

数据分析

AI 自动采集和分析设备数据,生成分析报告

05

性能监控

AI 自动采集设备性能数据和日志,实时监控应用状态

使用流程

简单六步,快速上手 UBox MCP 设备操作能力

1

初始化连接

AI Agent 通过 MCP 协议连接到 UBox MCP Server

→
2

身份认证

HTTP 请求头携带 Bearer Token 进行认证

→
3

发现能力

Agent 查询可用的设备操作工具列表

→
4

连接设备

调用 connect_device 连接目标设备

→
5

执行操作

调用各类工具执行设备操作

→
6

断开连接

调用 disconnect_device 释放设备资源

快速接入

支持 HTTP 和 SSE 两种传输模式,配置即可使用

HTTP Streamable HTTP 模式
{
  "mcpServers": {
    "ubox-mcp-server": {
      "transport": "http",
      "url": "https://dl.utest.21kunpeng.com/utest-paas-mcp/formal/ubox/mcp",
      "description": "UBox MCP Server",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
SSE Server-Sent Events 模式
{
  "mcpServers": {
    "ubox-mcp-server": {
      "transport": "sse",
      "url": "https://dl.utest.21kunpeng.com/utest-paas-mcp/formal/ubox/sse",
      "description": "UBox MCP Server",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

工具列表

涵盖设备管理、控制、应用、UI 分析、性能采集等全链路能力

设备管理

get_device_list获取设备列表,支持平台过滤与分页
connect_device连接指定设备,支持 normal/local 配置
disconnect_device断开设备连接,释放资源
get_connected_devices获取当前已连接设备列表
get_device_status查询设备在线/离线等状态
get_device_info获取设备硬件与系统详细信息

设备控制

take_screenshot截图并保存到文件,支持裁剪区域
take_screenshot_base64截图返回 Base64 格式数据
click_position按坐标点击屏幕,支持多点连击
click_element按元素定位点击(XPath/OCR/CV/UI)
long_click_element长按元素,支持自定义持续时间
slide_position坐标滑动,自定义起止点和时长
slide_between_elements元素间滑动,支持超时和按下时长
input_text输入文字到设备
press_button按键操作(Home/Back/Recent等)
execute_adb_command执行 ADB 命令

应用管理

start_application启动应用,可选清除数据
stop_application强制停止应用
get_current_application获取当前前台应用信息
get_running_applications获取所有运行中应用列表
install_application通过 URL 远程安装应用
install_local_application安装本地 APK/IPA,iOS 支持重签名
uninstall_application卸载指定应用

UI 分析

find_ui_element通过 XPath 查找 UI 元素
get_ui_tree获取完整 UI 树结构
get_element_by_cvCV 图像匹配定位元素
get_element_by_ocrOCR 文字识别定位元素
find_text_by_ocr通过 OCR 查找屏幕文字
find_image_by_cv通过 CV 图像匹配查找图片

数据采集与监控

set_clipboard_content设置设备剪贴板内容
get_clipboard_content获取设备剪贴板内容
start_screen_recording开始屏幕录制
stop_screen_recording停止屏幕录制
start_performance_collection开始性能数据采集
stop_performance_collection停止性能采集并输出报告
start_logcat_collection开始 Logcat 日志采集
stop_all_logcat_collection停止所有 Logcat 采集
start_anr_monitoring开始 ANR/Crash 监控
stop_anr_monitoring停止 ANR 监控并输出结果
ios_open_urliOS 打开 URL(iOS 专用)

集成指南

通过 MCP 客户端 SDK 快速接入,以下为 Python 示例

PythonAI Agent 自动化测试完整示例
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
import json

async def automated_test(): http_url = "http://localhost:8000/mcp" headers = {"Authorization": "Bearer YOUR_TOKEN"}
async with streamablehttp_client(url=http_url, headers=headers) as (read, write, _): async with ClientSession(read, write) as session: await session.initialize()
# 获取可用设备并连接 result = await session.call_tool("get_device_list", { "page_num": 1, "page_size": 10, "phone_platform": ["android"] }) devices = json.loads(result.content[0].text) udid = devices["data"]["devices"][0]["udid"]
await session.call_tool("connect_device", { "udid": udid, "os_type": "android" })
try: # 安装并启动应用 await session.call_tool("install_application", { "udid": udid, "app_url": "https://example.com/app.apk" }) await session.call_tool("start_application", { "udid": udid, "package": "com.example.testapp" }) await asyncio.sleep(2)
# 执行点击并截图验证 await session.call_tool("click_position", { "udid": udid, "pos": [0.5, 0.5] }) screenshot = await session.call_tool( "take_screenshot_base64", {"udid": udid} ) # 分析截图验证结果... finally: await session.call_tool("disconnect_device", {"udid": udid})
asyncio.run(automated_test())

UBox MCP Server - 优测PAAS云真机平台 AI Agent 设备操作能力

为企业及开发者提供专业的API测试 、压力测试、终端测试等产品及服务

footerLogo
客服热线
0755-86013388-843338
关注优测
热门产品
  • 云真机
  • 压力测试
  • 终端自动化测试
  • 后台一体化测试
热门服务
  • 服务性能测试
  • APP兼容测试
  • APP功能测试
  • APP隐私合规测试
  • 应用安全渗透测试
解决方案
  • 金融行业
  • 车联网行业
  • 泛互联网行业
  • 传统企业数字化转型
  • APP用户体验管理
  • 电商大促全链路压测
支持与服务
  • 帮助支持
  • 服务协议
  • 关于我们
友情链接
  • 腾讯端服务
  • 腾讯Bugly
  • TAPD
  • 霍格沃兹测试开发
Copyright ©2010-2026 Dalian SJKP Technology Co.,Ltd All Rights Reserved 大连市世纪鲲鹏科技有限公司 版权所有

辽公网安备 21029602000164号 辽ICP备11004471号-2