civyk-official/civyk-winwright

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

20 stars 1 forks 품질 71 트렌드 14NOASSERTION

Playwright-style MCP server for Windows desktop, system, and browser automation. 52 tools for WPF, WinForms, Win32, Chrome/Edge via Model Context Protocol.

개요

Windows automation server for the Model Context Protocol. 52 consolidated tools for desktop (WPF, WinForms, Win32), browser (Chrome/Edge via CDP), and system management — accessible to AI agents over MCP, . You write test cases in plain English. The AI agent uses WinWright's MCP tools to discover UI controls, perform actions, and record everything as a portable JSON script. Once recorded, scripts run deterministically with winwright run — no AI agent, no LLM calls, no token costs. Results are the same every time. If the UI layout changes, WinWright can broken selectors automatically (winwright heal). For larger UI redesigns, ask the AI agent to update the script — still faster than rewriting tests from scratch.

README

원문 README의 일부입니다. 원문 보기.

WinWright

Describe tests in plain English — the AI agent does the rest

You write test cases in plain English. The AI agent uses WinWright’s MCP tools to discover UI controls, perform actions, and record everything as a portable JSON script.

Replay recorded scripts — no AI agent needed

Once recorded, scripts run deterministically with winwright run — no AI agent, no LLM calls, no token costs. Results are the same every time.

If the UI layout changes, WinWright can self-heal broken selectors automatically (winwright heal). For larger UI redesigns, ask the AI agent to update the script — still faster than rewriting tests from scratch.

Why this matters:

Save AI costs — the agent records once, scripts replay for free
Deterministic results — every run produces identical, reproducible outcomes
Easy maintenance — self-healing selectors and AI-assisted script repair

Quick Start
Install
MCP Client Configuration
CLI Mode (when MCP is blocked)
Use Cases
Tools
Configuration
Who Is This For
How It Compares
Support
License

Quick Start

Install, configure your MCP client, then ask the agent to do something:

“Launch Notepad, type ‘Hello from WinWright’, then read back what you typed.”

The agent calls WinWright tools and returns results:

ww_launch    → { "processId": 12840, "mainWindowTitle": "Untitled - Notepad" }
ww_type      → { "success": true }
ww_get_value → { "value": "Hello from WinWright" }

Every tool returns structured JSON. The agent decides which tools to call and in what order — you describe the goal in plain language.

Install

Download from GitHub Releases:

Asset	Architecture
`winwright-*-win-x64.zip`	Intel/AMD 64-bit
`winwright-*-win-arm64.zip`	ARM64 (Surface Pro, etc.)

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "winwright": {
      "command": "C:/path/to/Civyk.WinWright.Mcp.exe",
      "args": ["mcp"]
    }
  }
}