bun-uia — MCP-сервер для Claude Code: управление GUI Windows
MCP-сервер, который даёт агенту доступ к нативным окнам Windows через UI Automation. Пригодится, когда нужно кликать и читать интерфейс программ, а не браузера.
claude mcp add --env BUN_UIA_PROFILE=<BUN_UIA_PROFILE> --env BUN_UIA_OS=<BUN_UIA_OS> --env BUN_UIA_ALLOW=<BUN_UIA_ALLOW> --env BUN_UIA_DENY=<BUN_UIA_DENY> --env BUN_UIA_CURSOR=<BUN_UIA_CURSOR> --transport stdio bun-uia -- npx -y bun-uiaЧто делает bun-uia
bun-uia — это MCP-сервер на Bun, который подключает агента к UI Automation в Windows. Через него ИИ-ассистент видит элементы нативных окон и может с ними работать: находить контролы, читать их состояние, управлять курсором. Автор описывает подход как «Playwright для десктопа Windows».
Запускается сервер командой npx -y bun-uia по stdio. Настройки передаются переменными окружения: BUN_UIA_PROFILE, BUN_UIA_OS, BUN_UIA_ALLOW, BUN_UIA_DENY, BUN_UIA_CURSOR. Через BUN_UIA_ALLOW и BUN_UIA_DENY задаётся, к каким приложениям агенту можно обращаться, а к каким нет. Без этих списков сервер запустится, но вы не ограничите его доступ к системе.
Сервер рассчитан на Windows, потому что UI Automation есть только там. На macOS и Linux он не заработает — это не вопрос настройки, а отсутствие самого API. Понадобится Node.js или Bun для запуска npx.
Какие задачи решает
- прочитать дерево элементов нативного окна Windows
- нажать кнопку в десктопной программе из агента
- ограничить агенту список доступных приложений
- отладить сценарий работы с GUI без ручного клика
- получить состояние контролов окна в текстовом виде
Примеры запросов агенту
- Подключись к окну блокнота и покажи, какие элементы там есть
- Найди в открытом окне кнопку «Сохранить» и нажми её
- Ограничь доступ агента только к приложению
calc.exeи проверь, что оно видит
Как установить bun-uia
Командой платформы
claude mcp add --env BUN_UIA_PROFILE=<BUN_UIA_PROFILE> --env BUN_UIA_OS=<BUN_UIA_OS> --env BUN_UIA_ALLOW=<BUN_UIA_ALLOW> --env BUN_UIA_DENY=<BUN_UIA_DENY> --env BUN_UIA_CURSOR=<BUN_UIA_CURSOR> --transport stdio bun-uia -- npx -y bun-uiaВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add bun-uia --env BUN_UIA_PROFILE=<BUN_UIA_PROFILE> --env BUN_UIA_OS=<BUN_UIA_OS> --env BUN_UIA_ALLOW=<BUN_UIA_ALLOW> --env BUN_UIA_DENY=<BUN_UIA_DENY> --env BUN_UIA_CURSOR=<BUN_UIA_CURSOR> -- npx -y bun-uiaВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"bun-uia": {
"command": "npx",
"args": [
"-y",
"bun-uia"
],
"env": {
"BUN_UIA_PROFILE": "<BUN_UIA_PROFILE>",
"BUN_UIA_OS": "<BUN_UIA_OS>",
"BUN_UIA_ALLOW": "<BUN_UIA_ALLOW>",
"BUN_UIA_DENY": "<BUN_UIA_DENY>",
"BUN_UIA_CURSOR": "<BUN_UIA_CURSOR>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"bun-uia": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bun-uia"
],
"env": {
"BUN_UIA_PROFILE": "<BUN_UIA_PROFILE>",
"BUN_UIA_OS": "<BUN_UIA_OS>",
"BUN_UIA_ALLOW": "<BUN_UIA_ALLOW>",
"BUN_UIA_DENY": "<BUN_UIA_DENY>",
"BUN_UIA_CURSOR": "<BUN_UIA_CURSOR>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e BUN_UIA_PROFILE=<BUN_UIA_PROFILE> -e BUN_UIA_OS=<BUN_UIA_OS> -e BUN_UIA_ALLOW=<BUN_UIA_ALLOW> -e BUN_UIA_DENY=<BUN_UIA_DENY> -e BUN_UIA_CURSOR=<BUN_UIA_CURSOR> bun-uia npx -y bun-uiaВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о bun-uia
Как установить bun-uia в Claude Code?
Выполните claude mcp add bun-uia -- npx -y bun-uia. Если нужны переменные окружения, используйте расширенный вариант: `claude mcp add --env BUN_UIA_PROFILE=<BUN_UIA_PROFILE> --env BUN_UIA_OS=<BUN_UIA_OS> --env BUN_UIA_ALLOW=<BUN_UIA_ALLOW> --env BUN_UIA_DENY=<BUN_UIA_DENY> --env BUN_UIA_CURSOR=<BUN_UIA_CURSOR> --transport stdio bun-uia -- npx -y bun-uia`.
Что делает bun-uia?
Даёт агенту доступ к UI Automation в Windows: поиск элементов в нативных окнах, чтение их состояния и управление ими. Работает как MCP-сервер по stdio.
На каких системах работает bun-uia?
Только на Windows, потому что UI Automation — часть этой ОС. На macOS и Linux сервер запустить не получится.
