# Handsy AI

MCP-сервер Handsy AI для Claude Code и Codex связывает агента с реальным iPhone через плату ESP32-S3. Управляет экраном через эмуляцию ввода без джейлбрейка и аккаунта разработчика.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5197 у репозитория
- Автор: onehumanbeing
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/onehumanbeing/esp32-iphone-agent
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/handsy-ai

## Что делает

MCP-сервер транслирует действия ассистента в команды для смартфона через микроконтроллер Seeed XIAO ESP32S3. Плата подключается как внешнее USB HID-устройство, а звук пересылается через AirPlay.

Для взаимодействия с интерфейсом на телефоне включается AssistiveTouch. Система работает на iOS 18+ вместе с приложением из TestFlight и прошивкой платы версии v0.2.4.

Во время выполнения сценариев смартфон расходует мобильный интернет, потому что модуль Wi-Fi занят точкой доступа платы.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add esp32agent -- npx -y esp32agent
```

### Codex

**Командой платформы**
```bash
codex mcp add handsy-ai -- npx -y esp32agent
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "handsy-ai": {
            "command": "npx",
            "args": [
                "-y",
                "esp32agent"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "handsy-ai": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "esp32agent"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add handsy-ai npx -y esp32agent
```

## Когда брать
- управлять интерфейсом приложений на реальном iPhone без джейлбрейка
- проходить сценарии в мобильных программах через ИИ-агента
- обрабатывать входящий звук из iOS через трансляцию AirPlay
- запускать автономные действия на телефоне без постоянного подключения к Mac

## Примеры запросов агенту
- Открой приложение Duolingo на айфоне и заверши текущий урок
- Проверь уведомления на подключённом iPhone и закрой баннеры
- Набери указанный номер телефона через стандартный интерфейс звонков

## Похожие
- [ios-mcp-jailbreak-automation](https://affpapa.org/nevibecode/skills/ios-mcp-jailbreak-automation.md) — скилл · 121 установка
- [Icemoon — control a real iPhone with AI](https://affpapa.org/nevibecode/mcp/icemoon-control-a-real-iphone-with-ai.md) — MCP-сервер
- [pi-app](https://affpapa.org/nevibecode/prompts/pi-app.md) — промпт · ★ 1754 у репозитория
- [mcp](https://affpapa.org/nevibecode/mcp/jettydiot-mcp.md) — MCP-сервер
- [iPhone Use](https://affpapa.org/nevibecode/mcp/iphone-use.md) — MCP-сервер · ★ 514 у репозитория
- [mirroir-mcp](https://affpapa.org/nevibecode/mcp/mirroir-mcp.md) — MCP-сервер · ★ 400 у репозитория

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