How do I install the mcp test utils mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MCP_LOG_DIR`, `MCP_LOG_MAX_MB`, `MCP_LOG_RETAIN_DAYS`, `MCP_SEARCH_DIRS` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Test Utils MCP Server

MCP server for automated desktop UI testing. A single binary — no runtime, no dependencies, no installation.

Local serverstdioGo

What is the MCP Test Utils MCP Server?

MCP server for automated desktop UI testing. A single binary — no runtime, no dependencies, no installation.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
take_screenshot	Screenshot of the entire desktop with configurable quality
take_window_screenshot	Screenshot of a specific window (screen or window capture mode)
read_screen_text	OCR the entire screen (Windows.Media.Ocr)
read_region_text	OCR a screen region with precise word coordinates
list_windows	List windows with id, title, app, position, size, minimized, focused
focus_window	Bring a window to front, restore if minimized
mouse_click	Click (left / right / middle) on a UI element by id, or at screen / window-relative coordinates
mouse_move	Move cursor to a point or to a UI element
mouse_drag	Drag from point A to point B
mouse_scroll	Scroll the mouse wheel
keyboard_type	Type text (full Unicode — Latin, Cyrillic, CJK, emoji)
keyboard_press	Press a key (Enter, Tab, F1–F12, arrows, etc.)
keyboard_shortcut	Key combinations (Ctrl+S, Alt+F4, Ctrl+Shift+P, etc.)
list_ui_elements	UI Automation tree — buttons, fields, menus with ids, values, states and exact coordinates; filters by name, value, class
wait_for	Wait for a window, an element or its state instead of sleeping
batch	Run up to 20 tool calls in one request, with find and assert steps
search_in_files	Search text or regex in files within allowed directories (like VS Code Find in Files)
find_files	Find files and directories by name pattern (glob), like "Go to File"
get_usage_guide	Compact workflow guide for LLM agents — precision clicking, coordinate metadata, quality tips
enable_logging	Start recording tool calls to JSONL + screenshots (opt-in)
disable_logging	Stop recording, get session stats

How to install the MCP Test Utils MCP Server

{
  "mcpServers": {
    "test-utils": {
      "command": "D:\\path\\to\\mcp-test-utils.exe"
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use MCP Test Utils to Vision.”
“Use MCP Test Utils to Input.”

Frequently asked questions

MCP server for automated desktop UI testing. A single binary — no runtime, no dependencies, no installation. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.