# MCP Test Utils

> MCP Test Utils is a free MCP server for developer tools. Windows desktop UI automation and regression testing for AI agents via MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Windows, CLI
- **Repository:** https://github.com/jeenyjai/mcp-test-utils
- **MCP Registry name:** io.github.JeenyJAI/mcp-test-utils
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says this server gives an AI agent screenshots, window control, mouse and keyboard input, UI Automation trees, and OCR, so it can drive a Windows application the way a tester would. Each click can be verified against the expected effect and retried, and a single binary runs with no runtime or installer.

Beyond interactive use, saved scenarios can be replayed without an agent from a script or CI job, with exit codes, JUnit output and per-row data runs. A recording mode turns a manual walkthrough into a draft scenario. Process metrics such as memory, handles and GDI objects can be sampled repeatedly to spot leaks.

The project targets QA engineers and developers testing Windows desktop software. It is currently Windows x64 only, and scenario runs are limited to 50 steps unless a license key is registered, while sealed scenarios run without the limit.

## Features

- **Verified UI interaction:** Clicks, typing and drags can wait for the expected effect and retry, and typed text is checked against the field.
- **UI Automation access:** Reads the element tree with ids, values, states and coordinates, and acts on elements without mouse or keyboard.
- **Scenario regression runs:** Replays saved scenarios, suites and CSV data rows with pass/fail reports and JUnit XML for CI.
- **Recording into drafts:** Captures actions in one window into a draft scenario that an agent can later refine.
- **Accessibility checks:** Flags unnamed controls, keyboard-unreachable controls, duplicate ids and zero-size controls.
- **Resource monitoring:** Reports memory, handles, GDI objects, threads and CPU of the application under test.

## Good for

- Run an agent-driven QA pass through an application and write a test report
- Replay saved desktop scenarios after each build in a CI job
- Record a manual walkthrough and turn it into an automated regression test
- Audit a Windows app for accessibility defects in its controls
- Check a desktop application for handle or GDI leaks across repeated actions

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-test-utils -- npx -y https://github.com/JeenyJAI/mcp-test-utils/releases/download/v3.27.23/mcp-test-utils.exe
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-test-utils": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/JeenyJAI/mcp-test-utils/releases/download/v3.27.23/mcp-test-utils.exe"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-test-utils": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/JeenyJAI/mcp-test-utils/releases/download/v3.27.23/mcp-test-utils.exe"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-test-utils": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/JeenyJAI/mcp-test-utils/releases/download/v3.27.23/mcp-test-utils.exe"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-test-utils": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/JeenyJAI/mcp-test-utils/releases/download/v3.27.23/mcp-test-utils.exe"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-test-utils": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/JeenyJAI/mcp-test-utils/releases/download/v3.27.23/mcp-test-utils.exe"
      ]
    }
  }
}
```

## Tools

- `take_screenshot`: Screenshot of the entire desktop with quality presets.
- `take_window_screenshot`: Screenshot of a specific window.
- `read_screen_text`: OCR the entire screen.
- `read_region_text`: OCR a screen region with word coordinates.
- `list_windows`: List windows with id, title, app, process id, position, size and state.
- `focus_window`: Bring a window to the front and optionally set its position and size.
- `launch_app`: Start a program from the configured allowlist and wait for its window.
- `close_window`: Close a window as its X button would and report save prompts.
- `mouse_click`: Click an element or coordinates with optional wait and retry.
- `mouse_move`: Move the cursor to a point or UI element.
- `mouse_drag`: Drag between elements or points at a human pace.
- `mouse_scroll`: Scroll the mouse wheel over an element.
- `keyboard_type`: Type Unicode text and verify the field shows it.
- `keyboard_press`: Press a key, optionally several times.
- `keyboard_shortcut`: Press a key combination.
- `list_ui_elements`: Return the UI Automation tree with filters.
- `get_focused_element`: Report which element has keyboard focus.
- `read_text`: Read full text of a document or field via UI Automation.
- `ui_action`: Invoke, toggle, expand, select, set value or scroll an element.
- `check_accessibility`: Report accessibility defects in controls.
- `process_info`: Report memory, handles, GDI objects, threads and CPU of the app.
- `wait_for`: Wait for a window, element or state.
- `batch`: Run up to 20 tool calls in one request.
- `run_scenario`: Replay a saved scenario, suite or data rows and get a report.
- `record_scenario`: Record actions in one window into a draft scenario.
- `search_in_files`: Search text or regex in allowed directories.
- `find_files`: Find files by glob pattern in allowed directories.
- `get_usage_guide`: Usage guide for agents with sections on request.
- `prepare_feedback`: Prepare a suggestions file for the author.
- `enable_logging`: Start recording tool calls to JSONL and screenshots.
- `disable_logging`: Stop recording and get session stats.

## FAQ

### Which operating systems are supported?

The README says it is Windows x64 only, with no macOS or Linux builds yet.

### Is it free to use?

The README says all tools are free; a license key only lifts the 50-step limit of scenario runs.

### How do I get a license key?

Keys are issued through early access; the README says the first 30 users get a free one-year key in exchange for feedback, requested by email with a machine code.

### Does it send data over the network?

The README says it opens no network ports and sends no data externally, going online only when the user clicks Check for updates.

### Is MCP Test Utils free?

Yes. MCP Test Utils is free to use.

### How do I add MCP Test Utils to Claude Code?

Run this command in your terminal: claude mcp add mcp-test-utils -- npx -y https://github.com/JeenyJAI/mcp-test-utils/releases/download/v3.27.23/mcp-test-utils.exe

### What are the best alternatives to MCP Test Utils?

The closest alternatives to MCP Test Utils are bad-ass-mcp, Mobai MCP, MCP Server, simplify3x-connect and Chrome DevTools MCP.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [bad-ass-mcp](https://ai-powered.com/mcp/bad-ass-mcp): bad-ass-mcp is an open-source MCP server for developer tools.
- [Mobai MCP](https://ai-powered.com/mcp/mobai-mcp): Mobai MCP is an open-source MCP server for developer tools.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mweo0sk4): MCP Server is an MCP server for developer tools.
- [simplify3x-connect](https://ai-powered.com/mcp/simplify3x-connect): simplify3x-connect is an open-source MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-4): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Swing MCP](https://ai-powered.com/mcp/swing-mcp): Swing MCP is an open-source MCP server for developer tools.
- [Testdino MCP](https://ai-powered.com/mcp/testdino-mcp): Testdino MCP is an MCP server for developer tools.
- [Clawdcursor](https://ai-powered.com/mcp/clawdcursor): Clawdcursor is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/mcp-test-utils
