winui-mcp-server

# WinUI MCP Server > [中文文档](README.cn.md) An MCP (Model Context Protocol) server that enables AI agents to control **any Windows desktop application** through UI Automation. No screen coordinates needed — controls are located by their class hierarchy and names. ## What It Does This server exposes 26 tools that let your AI agent: - **Discover** — explore the UIA tree of any window to find controls - **Click / Double-click / Right-click / Hover** — interact with controls by name or class - **Type / Send keys / Hotkeys** — keyboard input to any focused or targeted control - **Scroll** — scroll up/down on a control or window - **Read / Set values** — get or set text fields, spinboxes, checkboxes, comboboxes - **Wait** — wait for a control to appear or disappear (async UI) - **Window management** — list windows, get window state, focus, restore minimized windows Every tool returns structured JSON: `{"success": bool, "message": str, "data": dict}`. ## Prerequisites - **Windows 10/11** - **Python 3.10+** - **[uv](https://docs.astral.sh/uv/)** — fast Python package manager (`pip install uv`) ## Setup ### Install uv (if not already installed) ```bash pip install uv ``` ### Install the package ```bash git clone https://github.com/your-username/winui_mcp_server.git cd winui_mcp_server uv sync ``` Or install directly from PyPI (once published): ```bash uv tool install winui-mcp-server ``` ## Install as MCP Server The server runs via **stdio** transport. Below are configuration instructions for every major agent client. --- ### Claude Code Add to your project's `.claude/settings.json` or global `~/.claude/settings.json`: ```json { "mcpServers": { "winui": { "command": "uvx", "args": ["winui-mcp-server"] } } } ``` Restart Claude Code. The `winui` tools will appear in your tool list. --- ### Codex (OpenAI) In your Codex project, create or edit `.codex/config.json`: ```json { "mcp_servers": { "winui": { "command": "uvx…