UIAutomationMcp

Kit de herramientas de UI Automation para Windows con tres puntos de entrada alineados:

• CLI (uiamcp)

• Servidor MCP (UIAutomationMcp.McpServer)

• Extensión de VS Code (uia-mcp)

Instalación

Extensión de VS Code (recomendada): busque «UI Automation MCP» en Marketplace o instale el archivo UIAutomationMcp-<version>.vsix desde la última versión. Es autocontenida; incluye el servidor MCP, la CLI y ambas habilidades de agente.

Claude Desktop — descargue uia-mcp-<version>.mcpb de la última versión y haga doble clic en él.

Herramientas .NET de NuGet

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

ZIP independiente — UIAutomationMcp-MCP-Server-<version>-windows.zip contiene el servidor MCP y la CLI autocontenidos; no se requiere runtime de .NET.

Se requiere Windows y una sesión de escritorio interactiva. UI Automation no puede ejecutarse en modo headless.

Related MCP server: windows2text

Linaje

Este repositorio forma parte del linaje más amplio de automatización MCP y conserva deliberadamente la atribución al trabajo anterior de Stefan Brönner.

También mantiene la referencia histórica a Excel MCP como proyecto hermano relacionado dentro de ese linaje, aunque este repositorio se centra en Windows UI Automation.

Qué hace

• Inicia un cliente tipado de UI Automation a través de Interop.UIAutomationClient

• Lee metadatos detallados de la raíz del escritorio y del elemento enfocado, incluidos los límites, los identificadores de tempo de ejecución y los patrones admitidos

• Resuelve elementos a partir de identificadores de ventana nativos y coordenadas de pantalla

• Busca en los árboles de UIA por nombre, nombre de clase, ID de automatización, ID de framework, tipo de control e ID de proceso

• Enumera los hijos directos desde las vistas de árbol sin procesar, de control o de contenido

• Enumera los descendientes desde las vistas de árbol sin procesar, de control o de contenido

• Recorre el árbol de UIA con los recorridores de las vistas sin procesar, de control y de contenido

• Admite solicitudes de creación de caché para inspección, búsqueda y navegación

• Lee los estados de texto, selección y patrones de teclado

• Espera eventos de foco, de automatización, de cambio de propiedad y de cambio de estructura

• Realiza acciones comunes, como dar foco, invocar, asignar valores, alternar, expandir/contraer, seleccionar, cambiar el estado de la ventana, mover/redimensionar, desplazarse y actualizar valores de rango

• Expone la misma superficie más amplia a través de la CLI y de MCP

• Empaqueta la CLI y el servidor MCP dentro de la extensión de VS Code

Estructura del repositorio

• src\UIAutomationMcp.ComInterop

• src\UIAutomationMcp.Service

• src\UIAutomationMcp.CLI

• src\UIAutomationMcp.McpServer

• src\UIAutomationMcp.Smoke

• vscode-extension

• mcpb — fuentes y script de compilación del paquete para Claude Desktop

• skills — habilidades de agente para uia-cli y uia-mcp

Compilar y validar

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

Documentación relacionada

• Referencia de COM de UI Automation

• Guía de instalación

• Flujo de trabajo de desarrollo

• Contribuciones