@uicheck/mcp
Local MCP server for @uicheck/core. The browser page connects to this server through WebSocket, and AI agents call MCP tools to ask that page for screenshots and DOM element info.
Start
npm install -g @uicheck/mcp
uicheck-mcp
Default endpoints:
MCP: http://127.0.0.1:17322/mcp
Socket: ws://127.0.0.1:17322/socket
@uicheck/core
Configure the page script with the socket URL:
installUiCheck(html2canvas, {
position: 'bottom-left',
offset: [20, 20],
size: 36,
color: '#ef4444',
draggable: true,
socket: {
url: 'ws://127.0.0.1:17322/socket'
}
})
CDN query params are also supported:
<script src="http://127.0.0.1:17321/uicheck.js?socketUrl=ws://127.0.0.1:17322/socket"></script>
MCP Tools
| Tool | Description |
|---|---|
list_clients |
Lists connected @uicheck/core browser pages. |
capture_page |
Asks a connected page to return a PNG screenshot. |
inspect_elements |
Returns visible DOM selectors, text, layout boxes, and spacing info. |
get_element_at_point |
Returns the element and ancestors at viewport coordinates. |
CLI
uicheck-mcp --host 127.0.0.1 --port 17322
