McuBuddy v0.6.1

McuBuddy v0.6.1

McuBuddy v0.6.1 makes Codex integration persistent and self-repairing while tightening breakpoint
navigation semantics for real hardware debugging. Installed releases now carry the mcubuddy Skill,
so normal users can configure Codex without cloning the source repository.

Highlights

• Added McuBuddy setup codex/status/remove for persistent Codex MCP registration, repair, and
  verification with probe,diagnose enabled by default.
• Bundled the mcubuddy Skill inside the wheel so uv tool install McuBuddy no longer requires a Git
  checkout for Codex setup.
• Made the Skill proactively repair missing MCP registration when the user explicitly requests
  McuBuddy.
• Fixed continue-after-breakpoint behavior by stepping over the active breakpoint while preserving
  its ownership and restoring it safely.
• Made run-to-function and run-to-source distinguish target hits, timeouts, errors, and unrelated
  stops instead of reporting every stop as success.
• Added tool-surface guidance to runtime and doctor reports.

Upgrade Notes

Upgrade the installed package, run McuBuddy setup codex --repair --confirm --json, and restart
Codex so new tasks load the repaired MCP registration and bundled Skill.

Validation

The complete unit and integration suite passes, the wheel contains the bundled Skill resources,
and documentation, Skill, Ruff, and repository-diff validation all pass. No additional real-board
validation is claimed for this release.

McuBuddy v0.6.0

McuBuddy v0.6.0

This release improves hardware debugging, MCP tool management, and session safety.

Highlights

• Improved MCU capability detection and reduced diagnostic false positives.
• Fixed GDB startup and debug session cleanup issues.
• Added better ESP32 Flash and RTT support through probe-rs.
• Improved PY32 debugging workflows.
• Unified the MCP tool directory and restricted default tool exposure.
• Added project memory and onboarding improvements.
• Updated documentation, licensing information, and safety guidance.

mcudubby v0.5.0

mcudubby v0.5.0

mcudubby v0.5.0 重点加强并发执行、硬件操作安全边界、构建结果可信度和发布验证。

本版本包含

• 阻塞式 MCP 工具转移到工作线程，避免探针调用阻塞事件循环。
• 同一会话的硬件操作串行化，不同会话仍可并行执行。
• Keil 构建和烧录同时校验进程返回码与本次生成的日志，避免旧日志误报成功。
• smoke/first-contact 工具按实际行为标记为会改变目标执行状态。
• pyOCD GDB server 远程绑定新增显式确认，默认继续仅监听本机。
• MCP 工具的安全等级、确认要求和执行模式统一集中管理，DWT/SWO 启用及会改变目标状态的诊断命令均受一致策略约束。
• 探针重新配置改为事务式更新，无效连接参数不会替换当前后端或留下半更新配置。
• CI 新增 Windows、Rust sidecar、脚本 lint 和 skill 参考文档漂移检查。
• GitHub Release 自动构建并附加 wheel 与源码包。

安装

pip install mcudubby

也可以从本 Release 下载附件安装：

• mcudubby-0.5.0-py3-none-any.whl
• mcudubby-0.5.0.tar.gz

注意事项

涉及真实硬件的功能依赖本机探针驱动、板卡接线、目标固件符号文件，以及可选后端依赖，例如 pylink-square。远程开放 GDB server 前请确认网络边界可信。

mcudubby v0.4.0 首个公开版本

mcudubby v0.4.0

mcudubby 首个公开版本。它是一个面向 AI 辅助 MCU 调试和真实板卡固件诊断的 MCP 服务端，让 AI 助手可以通过调试探针、寄存器、内存、ELF/DWARF 符号、UART/RTT 日志、SVD 外设寄存器、RTOS 状态、flash 操作和 GDB server 生命周期工具观察真实 MCU 目标。

本版本包含

• MCP 服务入口：python -m mcudubby
• 探针控制：halt、resume、reset、单步、断点、观察点、寄存器、内存和 flash 操作
• pyOCD 后端：支持 ST-Link 和 CMSIS-DAP
• J-Link 后端：通过 pylink-square 支持
• ELF/DWARF 源码上下文：符号查询、栈检查、反汇编和源码导航
• UART、Segger RTT、SVD 外设寄存器、FreeRTOS 和 GDB server 工具
• 面向 AI 的诊断流程：启动失败、HardFault、栈溢出、外设异常、时钟问题和调试闭环
• 中英文文档、快速上手、支持矩阵，以及内置 mcubug assistant skill 参考资料

安装

pip install mcudubby

也可以从本 Release 下载附件安装：

• mcudubby-0.4.0-py3-none-any.whl
• mcudubby-0.4.0.tar.gz

注意事项

这是第一个公开基线版本。涉及真实硬件的功能依赖本机探针驱动、板卡接线、目标固件符号文件，以及可选后端依赖，例如 pylink-square。