mcpField
T
tauri-mcp-test-runner

tauri-mcp-test-runner

github.com/xiaolaiTesting & quality87861 installsUpdated today
Repository

About tauri-mcp-test-runner

A testing skill that runs VMark end-to-end UI flows with Tauri MCP tools and summarizes outcomes. It coordinates app windows, interactions, logs, and MCP sessions, including the key sequence for accepting AI suggestions.

Key features

  1. 01Start and stop Tauri driver sessions
  2. 02List windows and select a test target
  3. 03Run end-to-end UI flows
  4. 04Capture screenshots and inspect the DOM
  5. 05Read logs and summarize test results
  6. 06Accept AI suggestions with keystrokes

Use cases

  1. 01Test VMark desktop app UI flows
  2. 02Reproduce failures and collect error details
  3. 03Check document editing and formatting actions

MCP support

The skill uses Tauri MCP tools to control windows, keyboard input, and the WebView, and VMark MCP tools to perform document editing actions.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/xiaolai/vmark --skill tauri-mcp-test-runner

After installing, type/tauri-mcp-test-runnerin Claude Code to confirm it loaded.

Bundled filesreferences/flows.md

Details

From the project README

Tauri MCP Test Runner

Overview

Run VMark end-to-end UI flows using the Tauri MCP tools and summarize results.

Workflow

  1. Confirm the desktop app is running. If not, ask the user to start it.
  2. Start MCP session via mcp__tauri__tauri_driver_session (action: start, port: 9223 or omit for default).
  3. List windows (mcp__tauri__tauri_manage_window action: list) and pick the target window.
  4. Execute test flows using the patterns in references/flows.md.
  5. Capture logs when needed (mcp__tauri__tauri_read_logs) and stop the session when done.
  6. Report results: passed/failed flows, errors, repro steps, and any follow-up fixes.

Key Tools

Tauri MCP Tools (tauri-mcp server)
  • tauri_driver_session - Start/stop driver session
  • tauri_webview_screenshot - Capture current state
  • tauri_webview_keyboard - Send keystrokes (Enter, Escape, shortcuts)
  • tauri_webview_interact - Click, focus elements
  • tauri_webview_find_element - Inspect DOM state
VMark MCP Tools (vmark server)
  • document_insert_at_cursor - Insert text (appears as AI suggestion)
  • cursor_set_position - Move cursor to position
  • cursor_get_context - Get surrounding text context
  • selection_set / selection_get - Manage text selection
  • format_toggle - Toggle formatting (bold, italic, etc.)

Critical Pattern: AI Content Acceptance

When using vmark MCP to insert content, it appears as an AI suggestion that must be accepted with Enter via tauri-mcp:

1. vmark: document_insert_at_cursor("text")
2. tauri: keyboard(action: "press", key: "Enter")   # Accept
3. tauri: keyboard(action: "press", key: "Escape")  # Dismiss follow-up

This pattern is required for all content insertion operations.

References

  • Load references/flows.md for detailed flow patterns and examples.

Comments

Markdown supported