Mcp Control

mcp-control — browser + Windows control for Mavis

Two layers, in C:\Users\fvegi\.mavis\workspace\mcp-control\:

1. Browser — official playwright-cli (Microsoft, ships inside @playwright/mcp), driven over CDP against your running Edge. Uses the accessibility tree, not screenshots. No flash, no vision model needed.
2. Windows desktop — windows.cjs (PowerShell + .NET) for mouse, keyboard, screenshots, window management, clipboard, shell.

Quick start

# 1. Edge in debug mode (port 9223, profile MavisDebug)
cd "C:\Users\fvegi\.mavis\workspace\mcp-control"
.\start-edge-debug.bat

# 2. One-time attach
node mcp.cjs attach

# 3. Drive the browser
node mcp.cjs tabs                            # list tabs
node mcp.cjs snap                            # full a11y snapshot with refs (e15, e22, ...)
node mcp.cjs find "Kahnawake"                # search snapshot for an element
node mcp.cjs click e15                       # click by ref
node mcp.cjs fill e5 "hello@exemple.com"     # fill an input
node mcp.cjs type "search query"             # type into focused element
node mcp.cjs press Enter                     # press a key
node mcp.cjs eval "document.title"           # run JS, get string back
node mcp.cjs goto https://minimax.io         # navigate
node mcp.cjs shot out.png                    # screenshot (rare — snapshot is preferred)

# Windows desktop
node mcp.cjs screen out.png                  # desktop screenshot
node mcp.cjs lswin                           # list visible windows
node mcp.cjs focus "Claude"                  # activate a window

Why playwright-cli (a11y) and not CSS selectors

• No screenshot flash. Every interaction is text-based; nothing captures the screen.
• Deterministic. Refs (e15) are stable for the duration of a snapshot.
• Token-efficient. A snapshot is ~1-5 KB of YAML vs 1-2 MB for a screenshot.
• No vision model needed. Pure structured data.
• Recommended by Microsoft for coding agents (Mavis qualifies) — the README explicitly prefers CLI+SKILLs over MCP for this use case.

Files

How CDP setup works

1. start-edge-debug.bat launches Edge with --remote-debugging-port=9223 and --user-data-dir=%LOCALAPPDATA%\Microsoft\Edge\MavisDebug (separate profile, doesn't touch your normal Edge session).
2. mcp.cjs attach (or node pwcli.cjs attach) connects the CLI to that Edge via CDP. Run once per session.
3. The default session is then persisted in .playwright-cli/ so subsequent commands automatically reattach to the same Edge.
4. Port 9222 is intentionally left for Lenovo Vantage's existing debug endpoint.

pwcli.cjs — playwright-cli subcommands

pwcli.cjs is a thin wrapper. Anything not in the shortcuts list is forwarded verbatim to the official CLI. Full list:

open [url]                  open the browser
attach [name]               attach to a running playwright browser (--cdp, --endpoint, --extension)
close                       close the browser
detach                      detach from an attached browser
goto                   navigate to a url
type                  type text into editable element
click  [button]     perform click on a web page (target = ref or selector)
dblclick            perform double click
fill          fill text into editable element
drag   drag and drop between two elements
drop                drop files or data onto an element
hover               hover over element
select         select an option in a dropdown
upload                upload one or multiple files
check / uncheck     check / uncheck a checkbox or radio
snapshot [target]           capture page snapshot to obtain element ref
find [text]                 search the page snapshot for text or regexp
eval  [target]        evaluate javascript expression on page or element
dialog-accept / dialog-dismiss
resize                resize the browser window
delete-data                 delete session data
press                  press a key (e.g. Enter, ArrowDown, F5)
keydown / keyup        press/release a key
mousemove / mousedown / mouseup / mousewheel
screenshot [target]         take a screenshot (rare)
pdf --filename=...          save page as PDF
go-back / go-forward / reload

windows.cjs — subcommands

screenshot              Capture full screen to PNG
click                      Left-click at coords
dblclick                   Double-click
rightclick                 Right-click
move                       Move mouse
scroll                   Scroll wheel (+ up, - down)
type                       Type unicode text (clipboard paste)
key                        Press a key
chord                      Key chord (e.g. "ctrl+c", "alt+F4")
windows                          List visible top-level windows
find                Find window by title
activate            Bring window to front
clipboard get | set        Clipboard
run                     Run shell command
ps                       Run PowerShell
size                             Get primary screen size

Config for Mavis (or any MCP host)

mcp-servers.json in this directory is ready to use. The official @playwright/mcp server (v0.0.78) is registered there for hosts that prefer MCP transport. For Mavis specifically, the CLI approach (pwcli.cjs) is recommended by Microsoft for coding agents.

For Claude Desktop, copy the mcpServers block from mcp-servers.json into %APPDATA%\Claude\claude_desktop_config.json.

Safety notes

• windows run and windows ps execute arbitrary commands. Treat them like a shell.
• Screenshots and click events affect the user's actual desktop.
• windows activate will switch the foreground window out from under the user.
• playwright-cli over CDP sees and acts on whatever's open in the connected Edge session, including your logged-in state on any site — be careful what you click while you're logged in to sensitive accounts.