clawtouch-mcp — MCP-сервер для Claude Code
MCP-сервер передаёт агенту управление физической клавиатурой и мышью через USB HID. Нужен для тестовых стендов, киосков и машин с ограниченным доступом.
claude mcp add clawtouch-mcp -- uvx clawtouch-mcpЧто делает clawtouch-mcp
clawtouch-mcp — отдельный Python-процесс, который работает по MCP через stdio. Он предоставляет инструменты для кликов, ввода текста, прокрутки, сочетаний клавиш и скриншотов. Команды уходят на Raspberry Pi Pico 2 или другое устройство ClawTouch, а целевая система получает обычные USB HID-события.
Сервер можно подключить к Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и другим клиентам из списка платформ. Режим --mock запускает сервер без платы: действия только записываются в журнал. Для скриншотов предусмотрены варианты установки с mss и Pillow, а на macOS для работы с окнами нужен pyobjc.
Без Raspberry Pi Pico 2 с прошивкой ClawTouch HID физический ввод через сервер не заработает. Для разработки и CI есть clawtouch-mcp --mock --log-level INFO; с подключённым устройством можно задать порт через --port COM7 или размер экрана через --screen 1920x1080.
Какие задачи решает
- управлять клавиатурой и мышью через USB HID
- проверять обработку внешнего физического ввода
- запускать тестовый стенд с отдельной машиной
- отлаживать MCP-сценарии без подключённого устройства
Примеры запросов агенту
- Проверь размер экрана через инструмент
device.infoи сообщи обнаруженные параметры. - Кликни по указанным координатам, введи текст в активное окно и сделай скриншот.
- Запусти проверку в режиме
--mock, чтобы команды записывались без движения мыши.
Как установить clawtouch-mcp
Командой платформы
claude mcp add clawtouch-mcp -- uvx clawtouch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>
Командой платформы
codex mcp add clawtouch-mcp -- uvx clawtouch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>
Файл настроек
{
"mcpServers": {
"clawtouch-mcp": {
"command": "uvx",
"args": [
"clawtouch-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>
Файл настроек
{
"servers": {
"clawtouch-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"clawtouch-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>
Командой платформы
gemini mcp add clawtouch-mcp uvx clawtouch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о clawtouch-mcp
Как установить clawtouch-mcp в Claude Code?
Выполните claude mcp add clawtouch-mcp -- uvx clawtouch-mcp.
Что делает clawtouch-mcp?
Сервер даёт MCP-клиенту инструменты для физического ввода через USB HID: клики, набор текста, прокрутку, сочетания клавиш и скриншоты.
Можно ли запустить clawtouch-mcp без платы?
Да. Команда clawtouch-mcp --mock --log-level INFO не двигает устройство и записывает действия в журнал, поэтому подходит для разработки и CI.
