embedded-debugger

Solid

Embedded hardware debugging workflow for probe-rs targets using embedded-debugger-mcp. Use when Codex or Claude Code needs to inspect debug probes, validate embedded debugger setup, start the MCP server, guide a user through ARM Cortex-M/RISC-V flashing/debugging/RTT workflows, or operate without installing an MCP client by using the CLI plus prompts.

AI & Automation 132 stars 22 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
71
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Embedded Debugger Use the local `embedded-debugger-mcp` binary as the source of truth. Prefer CLI checks first, then MCP tools when an MCP client is available. ## Entry Decision 1. If the user has an MCP client configured, start or verify the server: `embedded-debugger-mcp serve` 2. If the user wants no MCP install, use CLI-first mode: `embedded-debugger-mcp doctor`, `embedded-debugger-mcp probes list`, and `embedded-debugger-mcp skill print-prompt`. 3. If hardware access is required, confirm the probe and target are connected before destructive actions such as flash erase or program. ## CLI Workflow Run these in order and report the exact outcome: ```bash embedded-debugger-mcp doctor embedded-debugger-mcp probes list embedded-debugger-mcp config show ``` Use JSON for automation: ```bash embedded-debugger-mcp doctor --json embedded-debugger-mcp probes list --json ``` ## Backends One tool set runs over two interchangeable engines, chosen at `connect`: - `backend: "probe-rs"` (default) — native probe-rs; supports flash and RTT. - `backend: "openocd"` (experimental) — talks to an already-running `openocd` over its GDB port via `openocd_address` (default `127.0.0.1:3333`). Use for chips probe-rs does not cover well (e.g. Xtensa ESP32 via openocd-esp32). Memory access and halt/run/step/reset are validated on real ESP32-S3; flash and RTT are not available on this backend. Register reads currently use ARM gdb register numbers, so PC/SP are wrong on...

Details

Author
Adancurusul
Repository
Adancurusul/embedded-debugger-mcp
Created
11 months ago
Last Updated
1 weeks ago
Language
Rust
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category