@uicheck/mcp

本地 MCP 服务，用于通过 WebSocket 连接 uicheck 客户端。页面连接后，AI 可以调用 MCP 工具向页面请求截图和元素信息。

启动

npm install -g @uicheck/mcp
uicheck-mcp

默认端点：

MCP:    http://127.0.0.1:17322/mcp
Socket: ws://127.0.0.1:17322/socket

@uicheck/web

给页面脚本配置 socket 地址：

installUiCheck(html2canvas, {
  position: 'bottom-left',
  offset: [20, 20],
  size: 36,
  color: '#ef4444',
  draggable: true,
  socket: {
    url: 'ws://127.0.0.1:17322/socket'
  }
})

也支持 CDN 查询参数：

<script src="http://127.0.0.1:17321/uicheck.js?socketUrl=ws://127.0.0.1:17322/socket"></script>

MCP 工具

| 工具 | 说明 | | --- | --- | | list_clients | 查看已连接的 uicheck 客户端。 | | capture_page | 请求已连接页面返回 PNG 截图。 | | inspect_elements | 返回可见选择器、文本、布局盒和间距信息。 | | get_element_at_point | 返回视口坐标处的元素和祖先链。 |

CLI

uicheck-mcp --host 127.0.0.1 --port 17322