{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_f335y2gdgcyj","handle":"uiautomation-mcp","url":"https://wellknown.network/agents/uiautomation-mcp","links":{"self":"https://wellknown.network/agents/uiautomation-mcp/record.json","html":"https://wellknown.network/agents/uiautomation-mcp","markdown":"https://wellknown.network/agents/uiautomation-mcp/record.md","api":"https://wellknown.network/api/v1/agents/uiautomation-mcp","status":"https://wellknown.network/api/v1/agents/uiautomation-mcp/status","claim":"https://wellknown.network/agents/uiautomation-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/uiautomation-mcp/claim.json","badge":"https://wellknown.network/agents/uiautomation-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/uiautomation-mcp/history","tools":"https://wellknown.network/api/v1/agents/uiautomation-mcp/tools"},"ard":{"identifier":"urn:air::server:uiautomation-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"uiautomation-mcp","summary":"MCP server for Windows desktop UI automation inspection and scripting via UI Automation API","description":"# uiautomation-mcp\n\n[![GitHub](https://img.shields.io/github/license/miloira/uiautomation-mcp)](https://github.com/miloira/uiautomation-mcp)\n\n基于 [UI Automation API](https://learn.microsoft.com/en-us/windows/win32/winauto/entry-uiauto-win32) 的 MCP Server，用于检查和自动化 Windows 桌面 UI 元素。\n\n为 AI 助手提供探索 UI 控件树、检查元素属性、执行操作（点击、输入、切换等）以及生成可直接使用的 Python 自动化脚本的能力。\n\n## 安装\n\n```bash\npip install uiautomation-mcp\n```\n\n或使用 [uv](https://docs.astral.sh/uv/)：\n\n```bash\nuv pip install uiautomation-mcp\n```\n\n## 使用方式\n\n### 命令行启动\n\n```bash\nuiautomation-mcp\n```\n\n通过 stdio 启动 MCP Server。\n\n### MCP 客户端配置\n\n添加到 MCP 客户端配置文件（如 `.kiro/settings/mcp.json`）：\n\n```json\n{\n  \"mcpServers\": {\n    \"uiautomation\": {\n      \"command\": \"uiautomation-mcp\",\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n也可以通过 uvx 直接运行（无需预装）：\n\n```json\n{\n  \"mcpServers\": {\n    \"uiautomation\": {\n      \"command\": \"uvx\",\n      \"args\": [\"uiautomation-mcp\"],\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n## 工具列表\n\n| 工具 | 说明 |\n|------|------|\n| `list_windows` | 列出桌面上所有可见的顶层窗口 |\n| `inspect_element_tree` | 从指定元素开始探索 UI 控件树 |\n| `get_element_detail` | 获取元素的完整详情，包括自动化模式和定位策略 |\n| `inspect_at_point` | 检查屏幕坐标处的 UI 元素 |\n| `find_elements` | 按名称、类型、AutomationId 或类名搜索元素 |\n| `capture_screenshot` | 截取窗口或桌面的屏幕截图 |\n| `activate_window` | 将窗口激活并置于前台 |\n| `perform_action` | 对元素执行操作（点击、输入、切换、展开等） |\n| `generate_script_snippet` | 生成可直接复制使用的 Python 自动化代码 |\n\n## 典型工作流\n\n1. `list_windows` — 找到目标应用窗口\n2. `activate_window` — 将窗口置于前台\n3. `inspect_element_tree` — 探索 UI 结构\n4. `find_elements` / `get_element_detail` — 定位具体控件\n5. `perform_action` — 与元素交互\n6. `generate_script_snippet` — 获取可复用的自动化代码\n\n## 系统要求\n\n- Windows 操作系统\n- Python >= 3.12\n\n## 许可证\n\nMIT","publisher":null,"homepage":"https://github.com/miloira/uiautomation-mcp","repository":"https://github.com/miloira/uiautomation-mcp","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["accessibility","desktop","mcp","rpa","ui-automation","windows"],"pricing":null,"endpoints":[{"url":"pypi:uiautomation-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"infra.desktop","name":"Desktop Control","confidence":1,"provenance":"declared"}],"categories":["infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"uiautomation-mcp","registry":"pypi","observedAt":"2026-10-22T22:25:00.793Z","publishedAt":"2026-08-08T14:42:50.274324Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"uiautomation-mcp","url":"https://pypi.org/project/uiautomation-mcp/","firstSeenAt":"2026-09-10T14:23:42.337Z","fetchedAt":"2026-10-22T22:23:51.880Z","normalizedAt":"2026-10-22T22:23:51.880Z"}]},"firstSeenAt":"2026-09-10T14:23:42.337Z","updatedAt":"2026-10-22T22:25:00.793Z"}