uiautomation-mcp

基于 UI Automation API 的 MCP Server，用于检查和自动化 Windows 桌面 UI 元素。

为 AI 助手提供探索 UI 控件树、检查元素属性、执行操作（点击、输入、切换等）以及生成可直接使用的 Python 自动化脚本的能力。

安装

pip install uiautomation-mcp

或使用 uv：

uv pip install uiautomation-mcp

使用方式

命令行启动

uiautomation-mcp

通过 stdio 启动 MCP Server。

MCP 客户端配置

添加到 MCP 客户端配置文件（如 .kiro/settings/mcp.json）：

{
  "mcpServers": {
    "uiautomation": {
      "command": "uiautomation-mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

也可以通过 uvx 直接运行（无需预装）：

{
  "mcpServers": {
    "uiautomation": {
      "command": "uvx",
      "args": ["uiautomation-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

工具列表

工具	说明
`list_windows`	列出桌面上所有可见的顶层窗口
`inspect_element_tree`	从指定元素开始探索 UI 控件树
`get_element_detail`	获取元素的完整详情，包括自动化模式和定位策略
`inspect_at_point`	检查屏幕坐标处的 UI 元素
`find_elements`	按名称、类型、AutomationId 或类名搜索元素
`capture_screenshot`	截取窗口或桌面的屏幕截图
`activate_window`	将窗口激活并置于前台
`perform_action`	对元素执行操作（点击、输入、切换、展开等）
`generate_script_snippet`	生成可直接复制使用的 Python 自动化代码

典型工作流

list_windows — 找到目标应用窗口
activate_window — 将窗口置于前台
inspect_element_tree — 探索 UI 结构
find_elements / get_element_detail — 定位具体控件
perform_action — 与元素交互
generate_script_snippet — 获取可复用的自动化代码

系统要求

Windows 操作系统
Python >= 3.12

许可证

MIT

Release files for uiautomation-mcp 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for uiautomation-mcp 0.1.2
File	Size	Uploaded
uiautomation_mcp-0.1.2.tar.gz	73.0 kB	Aug 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for uiautomation-mcp 0.1.2
File	Interpreter	ABI	Platform	Reset
uiautomation_mcp-0.1.2-py3-none-any.whl 10.5 kB Aug 8, 2026	Python 3	none	any	Details

Total release size: 83.5 kB

Release files / uiautomation_mcp-0.1.2.tar.gz

Download URL	uiautomation_mcp-0.1.2.tar.gz
Size	73.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`41e26db65e1d2f319b68e10e9284ca463e6f016d96c3434a667069342f2b689d`
BLAKE2b-256 checksum How to use checksums	`21872b935c4fe8909483c3c90aa4159959e2c2f44301fcbeee117def3cdf1512`
Upload date	Aug 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / uiautomation_mcp-0.1.2-py3-none-any.whl

Download URL	uiautomation_mcp-0.1.2-py3-none-any.whl
Size	10.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`17e53b55061a2a9f3840dd55cbe36381ab3ac651458855d49b4131ee2f777f2c`
BLAKE2b-256 checksum How to use checksums	`3b585c7337fb852af2de6ff15b0bd7fe9dc4879d9b2d0bd7b2d7f286d871053c`
Upload date	Aug 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`