uicheck_android

Source: README

Install

Android library: https://github.com/uicheck/uicheck, path packages/android

Android 原生运行时客户端。它把真实 Android 应用通过 WebSocket 接到 @uicheck/mcp,让 AI 请求截图并检查 Android view tree。

安装

把这个仓库作为 Android library 依赖添加:

https://github.com/uicheck/uicheck

包路径:

packages/android

单独启动 MCP 服务:

npx @uicheck/mcp

使用

在应用启动时安装客户端:

import ai.uicheck.android.UiCheckAndroidOptions
import ai.uicheck.android.UiCheckAndroidSocketOptions
import ai.uicheck.android.initUiCheck
 
val client = initUiCheck(
  UiCheckAndroidOptions(
    socket = UiCheckAndroidSocketOptions(
      url = "ws://127.0.0.1:17322/socket",
      clientId = "android-demo"
    ),
    activity = this
  )
)

不再需要时释放:

client.close()

选项

选项类型默认值说明
socket.urlString-@uicheck/mcp WebSocket 地址
socket.clientIdString-可选的稳定客户端 ID
socket.reconnectMsLong1000断线重连间隔
activityActivity-当前 Activity,用来自动读取根 View 和截图
screenshotfunction-可选截图 provider,用于 capture_pagecapture_elementcompare_screenshot,返回 PNG base64