OpenOCD Debugger — MCP-сервер для Claude Code: установка и функции
MCP-сервер OpenOCD Debugger для Claude Code подключает отладку микроконтроллеров к ИИ-ассистенту. Позволяет прошивать чипы, ставить точки останова и проверять регистры периферии прямо из чата.
MIT ★ 5 обновлён 2026-07-02
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Что делает OpenOCD Debugger
Сервер связывает ИИ с утилитой OpenOCD через отладочный программатор вроде ST-Link, J-Link или CMSIS-DAP. Ассистент управляет исполнением микроконтроллера: сбрасывает чип, шагает по инструкциям и прошивает образы .elf, .bin или .hex.
Для проверки состояния система читает переменные по именам символов из ELF и расшифровывает регистры периферии по файлу CMSIS-SVD. Поддерживаются аппаратные точки останова по условию и замер памяти без остановки процессора. Встроены барьеры безопасности: режим «только чтение» и защита от случайного стирания памяти.
Для запуска требуются Python 3.10+ и физически подключённый программатор. Исполняемый файл OpenOCD скачивается автоматически при первом запуске либо задаётся через переменную окружения OPENOCD_BIN.
Какие задачи решает
- прошить микроконтроллер файлом
.elf,.binили.hex - поставить условную точку останова или вотчпоинт на адрес памяти
- прочитать значения переменных по их именам из таблицы символов
- декодировать регистры периферии по файлу CMSIS-SVD
Примеры запросов агенту
- Прошей плату свежим бинарником
build/firmware.binи перезапусти её - Поставь точку останова на функцию
uart_rx_handlerи проверь значениеuart_rx_count - Прочитай битовые поля регистра
GPIOA.MODERчерез SVD-описание
Как установить OpenOCD Debugger
Командой платформы
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 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 <команда>
Файл настроек
{
"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 <команда>
Файл настроек
{
"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 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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об OpenOCD Debugger
Как установить OpenOCD Debugger в Claude Code?
Выполните команду claude mcp add openocd-mcp -- uvx openocd-mcp в терминале и перезапустите клиент.
Что делает OpenOCD Debugger?
Сервер даёт ассистенту доступ к отладке микроконтроллеров через OpenOCD: прошивке чипов, пошаговому выполнению, чтению регистров и просмотру переменных.
Что нужно для работы OpenOCD Debugger?
Нужны Python 3.10+, физический программатор (ST-Link, J-Link, CMSIS-DAP) и подключённая плата. Сам OpenOCD скачается автоматически при первом соединении.