# clawtouch-mcp

MCP-сервер передаёт агенту управление физической клавиатурой и мышью через USB HID. Нужен для тестовых стендов, киосков и машин с ограниченным доступом.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Автор: tinqiao-oss
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/tinqiao-oss/clawtouch-mcp
- Обновлён: 2026-10-15
- HTML: https://affpapa.org/nevibecode/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`.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add clawtouch-mcp -- uvx clawtouch-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add clawtouch-mcp -- uvx clawtouch-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "clawtouch-mcp": {
            "command": "uvx",
            "args": [
                "clawtouch-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "clawtouch-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "clawtouch-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add clawtouch-mcp uvx clawtouch-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from clawtouch-mcp <команда>

## Когда брать
- управлять клавиатурой и мышью через USB HID
- проверять обработку внешнего физического ввода
- запускать тестовый стенд с отдельной машиной
- отлаживать MCP-сценарии без подключённого устройства

## Примеры запросов агенту
- Проверь размер экрана через инструмент `device.info` и сообщи обнаруженные параметры.
- Кликни по указанным координатам, введи текст в активное окно и сделай скриншот.
- Запусти проверку в режиме `--mock`, чтобы команды записывались без движения мыши.

## Похожие
- [input-keyboard-mouse-touch](https://affpapa.org/nevibecode/skills/input-keyboard-mouse-touch.md) — скилл · 946 установок
- [better-accessibility](https://affpapa.org/nevibecode/skills/better-accessibility.md) — скилл · 29600 установок
- [wcag-audit-patterns](https://affpapa.org/nevibecode/skills/wcag-audit-patterns.md) — скилл · 12486 установок
- [compose-focus-navigation](https://affpapa.org/nevibecode/skills/compose-focus-navigation.md) — скилл · 1900 установок
- [antislop-human](https://affpapa.org/nevibecode/skills/antislop-human.md) — скилл · 5900 установок
- [capacitor-keyboard](https://affpapa.org/nevibecode/skills/capacitor-keyboard.md) — скилл · 1000 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md