core — MCP-сервер для Electron: что делает и как установить
MCP-сервер, через который агент запускает настоящие Electron-приложения, читает дерево доступности, кликает по стабильным ссылкам и проверяет поведение с повторами.
claude mcp add core -- npx -y @electron-stagewright/coreЧто делает core
Сервер открывает агенту доступ к живому Electron-приложению: запуск или подключение к уже работающему процессу, разбор дерева доступности, взаимодействие по устойчивым ссылкам на элементы. Проверки идут через примитивы expect_* с таймаутом и повторами, поэтому цепочка «прочитать, сравнить, подождать» укладывается в один вызов.
Внутри — инструменты electron_launch, electron_attach, electron_snapshot, electron_find, get_state, wait_for_state и другие. Ошибки приходят с подсказками и похожими ссылками, в ответах указана стоимость в токенах, а get_state отдаёт всё состояние элемента за раз: видим, включён, в фокусе, раскрыт. Снимок помечает элементы, которые изменились с прошлого раза, и умеет отдавать только разницу. Для трассировки сессии есть воспроизведение вызовов на чистом экземпляре приложения и лимиты токенов. Отдельно закрыты упакованные сборки: проверка подписи, оценка Gatekeeper, лента autoUpdater.
Нужен Node.js 24 или новее. На Linux понадобится дисплей — DISPLAY, WAYLAND_DISPLAY или xvfb-run -a, иначе серверу негде рисовать окно. Первый запуск Electron скачивает бинарник уже во время работы, а не при установке, и печатает строку прогресса в stdout: в сессии MCP она попадёт в поток протокола. Поэтому бинарник готовят заранее командой install-electron, а затем проверяют doctor — он завершается с кодом 0, когда обязательные проверки прошли. Список пакетов держите одинаковым во всех командах: npx кеширует каждый набор отдельно.
Какие задачи решает
- запустить Electron-приложение из сессии агента и осмотреть его окна
- проверить, что кнопка стала активной, без череды повторных запросов
- найти элемент по роли и части имени вместо CSS-селектора
- подключиться к уже запущенному dev-серверу, не перезапуская его
- проверить подпись и упаковку готовой
.app-сборки
Примеры запросов агенту
- Запусти приложение и покажи дерево доступности главного окна.
- Найди кнопку с частью имени «Отправить» и проверь, что она включена, с таймаутом 5000.
- Подключись к работающему dev-серверу и сравни снимок с прошлым.
Как установить core
Командой платформы
claude mcp add core -- npx -y @electron-stagewright/coreКомандой платформы
codex mcp add electron-stagewright-core -- npx -y @electron-stagewright/coreФайл настроек
{
"mcpServers": {
"electron-stagewright-core": {
"command": "npx",
"args": [
"-y",
"@electron-stagewright/core"
]
}
}
}Файл настроек
{
"servers": {
"electron-stagewright-core": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@electron-stagewright/core"
]
}
}
}Командой платформы
gemini mcp add electron-stagewright-core npx -y @electron-stagewright/coreПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о core
Как установить core в Claude Code?
Добавьте сервер командой claude mcp add core -- npx -y @electron-stagewright/core. Проверить подключение можно через claude mcp list или командой /mcp внутри сессии.
Что делает core?
Управляет настоящим Electron-приложением по протоколу MCP: запускает или присоединяется к процессу, читает дерево доступности, кликает по элементам и проверяет их состояние с повторами.
Что нужно подготовить до настройки MCP-хоста?
Поставьте бинарник Electron заранее через install-electron и прогоните doctor: иначе скачивание Electron при первом запуске выведет строку прогресса в stdout и она попадёт в поток протокола MCP.
