# ESP32 Simulator

MCP-сервер ESP32 Simulator для Claude Code запускает прошивки ESP32 в локальном эмуляторе без реальной платы. Инструмент перехватывает вывод UART, эмулирует ввод и проверяет логи на паники.

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

## Что делает

Сервер связывает агента с эмулятором esp32sim и запускает сборку ESP-IDF через локальное окружение или Docker. Эмуляция воспроизводит ROM Espressif, загрузчик и бинарник приложения. Поддерживаются чипы ESP32, ESP32-S3, C3 и C6.

В набор входят `sim_run` для чтения логов консоли, `sim_expect` для проверки строк по шаблону, `sim_script` для эмуляции кнопок и переключения GPIO. Инструмент `sim_screenshot` сохраняет кадры виртуального экрана. Работает виртуальный Wi-Fi с DHCP и NAT.

Для запуска нужны Node.js 22+ и ESP-IDF либо Docker. Готовые бинарники эмулятора доступны для macOS на Apple silicon и Linux (x64, arm64).

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

## Установка

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

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

### Codex

**Командой платформы**
```bash
codex mcp add esp32-simulator -- npx -y esp32sim-mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add esp32-simulator npx -y esp32sim-mcp
```

## Когда брать
- проверить загрузку прошивки ESP32 без подключения платы к компьютеру
- перехватить ошибки Guru Meditation и сбои кучи в автоматических тестах
- эмулировать нажатия кнопок, энкодер и Wi-Fi в сценариях
- сохранить снимок экрана платы для проверки графического интерфейса

## Примеры запросов агенту
- Собери проект в Docker и проверь через `sim_expect`, что в консоли появляется строка Counter: 5.
- Запусти эмуляцию ESP32-S3 на 10 секунд и сделай скриншот дисплея.
- Проверь прошивку на паники и покажи лог UART после старта.

## Похожие
- [esp32-wroom-38pin](https://affpapa.org/nevibecode/skills/esp32-wroom-38pin.md) — скилл · ★ 29 у репозитория
- [esp32-wroom-36pin](https://affpapa.org/nevibecode/skills/esp32-wroom-36pin.md) — скилл · ★ 29 у репозитория
- [esp32-firmware-engineer](https://affpapa.org/nevibecode/skills/esp32-firmware-engineer.md) — скилл · 1500 установок
- [esp32-ai-agent-skill](https://affpapa.org/nevibecode/plugins/esp32-ai-agent-skill.md) — плагин · ★ 59 у репозитория
- [ota-deployment-guardian](https://affpapa.org/nevibecode/skills/ota-deployment-guardian.md) — скилл · 115 установок
- [flashduck-dev](https://affpapa.org/nevibecode/skills/flashduck-dev.md) — скилл · ★ 187 у репозитория

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