English Français العربية

UIAutomationMcp

Registre officiel Autres

Windows UI Automation MCP server for desktop inspection and element lookup. Windows only.

Code source Documentation

Que pouvez-vous faire avec UIAutomationMcp ?

  • boots a typed UI Automation client through Interop.UIAutomationClient
  • reads rich desktop-root and focused-element metadata, including bounds, runtime IDs, and supported patterns
  • resolves elements from native window handles and screen coordinates
  • searches UIA trees by name, class name, automation id, framework id, control type, and process id
  • enumerates immediate children from raw, control, or content tree views
  • enumerates descendants from raw, control, or content tree views
  • navigates the UIA tree with raw, control, and content walkers
  • supports build-cache requests for inspection, search, and navigation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NUGET package UIAutomationMcp.McpServer
Claude Code 
claude mcp add uiautomationmcp -- dnx UIAutomationMcp.McpServer@1.0.2 --yes
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "uiautomationmcp": {
            "command": "dnx",
            "args": [
                "UIAutomationMcp.McpServer@1.0.2",
                "--yes"
            ]
        }
    }
}
NPM package uia-mcp
Claude Code 
claude mcp add uiautomationmcp -- npx -y uia-mcp@1.0.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "uiautomationmcp": {
            "command": "npx",
            "args": [
                "-y",
                "uia-mcp@1.0.2"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. UIAutomationMcp
  2. Install
  3. Lineage
  4. What it does
  5. Repository layout
  6. Build and validate
  7. Related docs

UIAutomationMcp

Windows UI Automation toolkit with three aligned entry points:

  • CLI (uiamcp)
  • MCP server (UIAutomationMcp.McpServer)
  • VS Code extension (uia-mcp)

Install

VS Code extension (recommended) — install trsdn.uia-mcp from the Marketplace (code --install-extension trsdn.uia-mcp), or install the UIAutomationMcp-<version>.vsix from the latest release. Self-contained; bundles the MCP server, the CLI, and both agent skills.

Claude Desktop — download uia-mcp-<version>.mcpb from the latest release and double-click it.

npm — uia-mcp ships the MCP server with the .NET runtime bundled, so it needs no prerequisites:

{
  "mcpServers": {
    "uia-mcp": { "command": "npx", "args": ["-y", "uia-mcp"] }
  }
}

NuGet .NET tools

dotnet tool install --global UIAutomationMcp.McpServer   # MCP server -> uiamcp-server
dotnet tool install --global UIAutomationMcp.CLI         # CLI        -> uiamcp

Standalone ZIP — UIAutomationMcp-MCP-Server-<version>-windows.zip contains the self-contained MCP server and CLI; no .NET runtime required.

Requires Windows and an interactive desktop session. UI Automation cannot run headless.

Lineage

This repository is part of the broader MCP automation lineage and intentionally keeps attribution to earlier work by Stefan Brönner.

It also keeps the historical reference to Excel MCP as a related sibling project in that lineage, even though this repository itself is focused on Windows UI Automation.

What it does

  • boots a typed UI Automation client through Interop.UIAutomationClient
  • reads rich desktop-root and focused-element metadata, including bounds, runtime IDs, and supported patterns
  • resolves elements from native window handles and screen coordinates
  • searches UIA trees by name, class name, automation id, framework id, control type, and process id
  • enumerates immediate children from raw, control, or content tree views
  • enumerates descendants from raw, control, or content tree views
  • navigates the UIA tree with raw, control, and content walkers
  • supports build-cache requests for inspection, search, and navigation
  • reads text, selection, and key pattern states, including caret position, annotation runs such as spelling errors, and the containing document of an inline element
  • waits for focus, automation, property-changed, and structure-changed events
  • performs common actions such as focus, invoke, set-value, toggle, expand/collapse, selection, window state changes, move/resize, scroll, range-value updates, view switching, docking, realizing virtualized items, and MSAA default actions
  • finds items that a virtualizing list has not materialized yet by asking the container directly, so a search for the 250th row of a 300-row list works without scrolling
  • reports drag and drop state (isGrabbed, drop effects, grabbed items) so an in-progress drag can be observed, and resolves automation events to readable names such as Drag_DragStart
  • reads MSAA data through the LegacyIAccessible bridge, so Win32, MFC, and installer windows that expose no native UI Automation provider still report usable names, roles, states, and a runnable default action
  • reads tabular controls as a cell matrix with row and column headers
  • exposes the same expanded surface through CLI and MCP
  • packages the CLI and MCP server inside the VS Code extension

Repository layout

  • src\UIAutomationMcp.ComInterop
  • src\UIAutomationMcp.Service
  • src\UIAutomationMcp.CLI
  • src\UIAutomationMcp.McpServer
  • src\UIAutomationMcp.Smoke
  • vscode-extension
  • mcpb — Claude Desktop bundle sources and build script
  • skills — agent skills for uia-cli and uia-mcp

Build and validate

dotnet build .\UIAutomationMcp.sln -c Release
.\src\UIAutomationMcp.Smoke\bin\Release\net9.0-windows\UIAutomationMcp.Smoke.exe
.\src\UIAutomationMcp.CLI\bin\Release\net9.0-windows\uiamcp.exe inspect --root --cache
.\src\UIAutomationMcp.CLI\bin\Release\net9.0-windows\uiamcp.exe find --focused --scope children --max-results 10 --cache
.\src\UIAutomationMcp.CLI\bin\Release\net9.0-windows\uiamcp.exe children --focused --view raw --max-results 10
.\src\UIAutomationMcp.CLI\bin\Release\net9.0-windows\uiamcp.exe descendants --focused --view raw --max-results 25
.\src\UIAutomationMcp.CLI\bin\Release\net9.0-windows\uiamcp.exe wait-event --event-kind focus --timeout-ms 500
.\src\UIAutomationMcp.CLI\bin\Release\net9.0-windows\uiamcp.exe action focus --focused

Questions fréquentes

Qu'est-ce que UIAutomationMcp ?

Windows UI Automation MCP server for desktop inspection and element lookup. Windows only.

Comment installer UIAutomationMcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add uiautomationmcp -- dnx UIAutomationMcp.McpServer@1.0.2 --yes. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour UIAutomationMcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

UIAutomationMcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient UIAutomationMcp ?

Il est publié par trsdn. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.