McuBuddy — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер связывает нейросеть с микроконтроллером через программаторы для пошаговой отладки, чтения логов и сборки прошивок.
claude mcp add mcubuddy -- uvx McuBuddyЧто делает McuBuddy
McuBuddy даёт языковым моделям доступ к отладке встраиваемых систем на реальном оборудовании. Сервер работает локально через стандартные потоки stdio и связывается с платами через программаторы ST-Link, J-Link или CMSIS-DAP с помощью бэкендов pyOCD и probe-rs. По умолчанию запускается базовый профиль с 19 инструментами. Дополнительные модули вроде rtos или build_flash активируются переменной окружения MCUBUDDY_TOOLSETS.
Ассистент умеет декодировать регистры периферии по файлам CMSIS-SVD, анализировать стеки задач FreeRTOS и сопоставлять аппаратные сбои со строками исходного кода через таблицы символов ELF и DWARF. При этом сборка проектов .uvprojx опирается на утилиту UV4.exe, поэтому компиляция и прошивка через Keil MDK работают исключительно в среде Windows. Важно учитывать, что чтение контекста останавливает ядро процессора, нарушая непрерывную работу микроконтроллера.
Какие задачи решает
- локализовать сбои HardFault и переполнения стека по символам ELF
- декодировать значения регистров периферии через CMSIS-SVD
- проинспектировать задачи и контекст FreeRTOS на работающем чипе
- собрать и прошить проект Keil MDK с помощью
UV4.exe
Примеры запросов агенту
- Найди подключённые программаторы и прочитай текущее состояние чипа py32f030x8 через McuBuddy.
- Изучи файл прошивки firmware.elf и определи адрес сбоя HardFault по регистрам процессора.
- Проверь распределение стека в задачах FreeRTOS и выведи свежие логи из RTT.
Как установить McuBuddy
Командой платформы
claude mcp add mcubuddy -- uvx McuBuddyuvx запускает команду с именем пакета; если в README она другая — uvx --from McuBuddy <команда>
Командой платформы
codex mcp add mcubuddy -- uvx McuBuddyuvx запускает команду с именем пакета; если в README она другая — uvx --from McuBuddy <команда>
Файл настроек
{
"mcpServers": {
"mcubuddy": {
"command": "uvx",
"args": [
"McuBuddy"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from McuBuddy <команда>
Файл настроек
{
"servers": {
"mcubuddy": {
"type": "stdio",
"command": "uvx",
"args": [
"McuBuddy"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from McuBuddy <команда>
Командой платформы
gemini mcp add mcubuddy uvx McuBuddyuvx запускает команду с именем пакета; если в README она другая — uvx --from McuBuddy <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о McuBuddy
Как установить McuBuddy в Claude Code?
Выполните команду claude mcp add mcubuddy -- uvx McuBuddy. Для запуска потребуется окружение с Python версии 3.10 или новее.
Что делает McuBuddy?
Сервер переводит запросы нейросети в вызовы аппаратных отладчиков pyOCD или J-Link. Это позволяет считывать память чипа, проверять регистры периферии и перехватывать потоки логов UART и RTT.
Можно ли запускать сборку Keil MDK на macOS или Linux?
Сборка и прямая прошивка вызывают UV4.exe, поэтому этот блок требует установленного Keil MDK на Windows. При этом прямое чтение регистров и сбор логов через pyOCD работают без привязки к Windows.
