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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
uiautomation_mcp-0.1.2.tar.gz
(73.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file uiautomation_mcp-0.1.2.tar.gz.
File metadata
- Download URL: uiautomation_mcp-0.1.2.tar.gz
- Upload date:
- Size: 73.0 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
41e26db65e1d2f319b68e10e9284ca463e6f016d96c3434a667069342f2b689d
|
|
| MD5 |
155c327566ce9a50dd038b89a348d8d0
|
|
| BLAKE2b-256 |
21872b935c4fe8909483c3c90aa4159959e2c2f44301fcbeee117def3cdf1512
|
File details
Details for the file uiautomation_mcp-0.1.2-py3-none-any.whl.
File metadata
- Download URL: uiautomation_mcp-0.1.2-py3-none-any.whl
- Upload date:
- Size: 10.5 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
17e53b55061a2a9f3840dd55cbe36381ab3ac651458855d49b4131ee2f777f2c
|
|
| MD5 |
47b2be39ebb1e3a0a7c9cebdcf917626
|
|
| BLAKE2b-256 |
3b585c7337fb852af2de6ff15b0bd7fe9dc4879d9b2d0bd7b2d7f286d871053c
|
