# OpenOCD Debugger

MCP-сервер OpenOCD Debugger для Claude Code подключает отладку микроконтроллеров к ИИ-ассистенту. Позволяет прошивать чипы, ставить точки останова и проверять регистры периферии прямо из чата.

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

## Что делает

Сервер связывает ИИ с утилитой OpenOCD через отладочный программатор вроде ST-Link, J-Link или CMSIS-DAP. Ассистент управляет исполнением микроконтроллера: сбрасывает чип, шагает по инструкциям и прошивает образы `.elf`, `.bin` или `.hex`.

Для проверки состояния система читает переменные по именам символов из ELF и расшифровывает регистры периферии по файлу CMSIS-SVD. Поддерживаются аппаратные точки останова по условию и замер памяти без остановки процессора. Встроены барьеры безопасности: режим «только чтение» и защита от случайного стирания памяти.

Для запуска требуются Python 3.10+ и физически подключённый программатор. Исполняемый файл OpenOCD скачивается автоматически при первом запуске либо задаётся через переменную окружения `OPENOCD_BIN`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `OPENOCD_BIN`, `OPENOCD_MCP_CONFIG`, `OPENOCD_MCP_READONLY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env OPENOCD_BIN=<OPENOCD_BIN> --env OPENOCD_MCP_CONFIG=<OPENOCD_MCP_CONFIG> --env OPENOCD_MCP_READONLY=<OPENOCD_MCP_READONLY> --transport stdio openocd-debugger -- uvx openocd-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openocd-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add openocd-debugger --env OPENOCD_BIN=<OPENOCD_BIN> --env OPENOCD_MCP_CONFIG=<OPENOCD_MCP_CONFIG> --env OPENOCD_MCP_READONLY=<OPENOCD_MCP_READONLY> -- uvx openocd-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openocd-mcp <команда>

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e OPENOCD_BIN=<OPENOCD_BIN> -e OPENOCD_MCP_CONFIG=<OPENOCD_MCP_CONFIG> -e OPENOCD_MCP_READONLY=<OPENOCD_MCP_READONLY> openocd-debugger uvx openocd-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openocd-mcp <команда>

## Когда брать
- прошить микроконтроллер файлом `.elf`, `.bin` или `.hex`
- поставить условную точку останова или вотчпоинт на адрес памяти
- прочитать значения переменных по их именам из таблицы символов
- декодировать регистры периферии по файлу CMSIS-SVD

## Примеры запросов агенту
- Прошей плату свежим бинарником `build/firmware.bin` и перезапусти её
- Поставь точку останова на функцию `uart_rx_handler` и проверь значение `uart_rx_count`
- Прочитай битовые поля регистра `GPIOA.MODER` через SVD-описание

## Похожие
- [openocd-jtag](https://affpapa.org/nevibecode/skills/openocd-jtag.md) — скилл · 637 установок
- [embedded-systems](https://affpapa.org/nevibecode/agents/voltagent-embedded-systems.md) — субагент · ★ 6505 у репозитория
- [domain-embedded](https://affpapa.org/nevibecode/skills/domain-embedded.md) — скилл · 3200 установок
- [McuBuddy](https://affpapa.org/nevibecode/mcp/mcubuddy.md) — MCP-сервер · ★ 12 у репозитория
- [freertos](https://affpapa.org/nevibecode/skills/freertos.md) — скилл · 739 установок
- [lgt8f328p-minievb](https://affpapa.org/nevibecode/skills/lgt8f328p-minievb.md) — скилл · ★ 29 у репозитория

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