Dbgprobe MCP Server

Write data to target memory. Provide data in one of: 'hex' (hex string), 'base64', or 'u32' (array of 32-bit words, little-endian).

List loaded plugins with their tool names and metadata. Each plugin may include a 'meta' dict with matching hints like device_name_contains or description — use these to determine which plugin fits the connected device. Also returns whether plugins are enabled and the current policy. Plugins require DBGPROBE_MCP_PLUGINS env var — set to 'all' for all or 'name1,name2' to allow specific plugins. If disabled, tell the user to set this variable when adding the MCP server.

Load a new plugin from a file or directory path. Requires DBGPROBE_MCP_PLUGINS env var to be set.

Hot-reload a plugin by name. Re-imports the module and refreshes tools. Requires DBGPROBE_MCP_PLUGINS env var to be set.

Return a Python plugin template. Use this when creating a new plugin. Optionally pre-fill with a device name. Save the result to .dbgprobe_mcp/plugins/<name>.py, fill in the tools and handlers, then load with dbgprobe.plugin.load.

List attached debug probes. Returns vendor/backend-specific info (serial number, description). For J-Link, enumerates via JLinkExe.

Reset the target. Modes: 'soft' (default) — software reset and resume, 'hard' — hardware reset, 'halt' — reset and halt at first instruction.

Read buffered RTT data from the target. Returns data as text (UTF-8 by default) or hex. Non-blocking — returns whatever is buffered, waiting up to timeout seconds for initial data.

Start RTT (Real-Time Transfer) on a connected session. Connects to the JLinkGDBServer RTT telnet port and begins buffering target output (channel 0). Optional address hint for the RTT control block in target RAM.

Return RTT status: active, bytes buffered, total read/written.

Stop RTT and disconnect from the telnet port.

Write data to the target via RTT channel 0. Input is text (UTF-8 by default) or hex-encoded bytes.

Attach a registered spec to a connection session (in-memory only). The spec will be available via dbgprobe.spec.get for the duration of this connection. After attaching, check dbgprobe.plugin.list for a matching plugin, then present the user with their options: interact with the device using the spec (send commands, execute flows), use plugin shortcut tools if a plugin is loaded, extend an existing plugin with new tools, or create a new plugin using dbgprobe.plugin.template.

Get the attached spec for a connection (returns null if none attached).

List all registered specs with their metadata and matching hints.

Read full spec content, file path, and metadata by spec_id.

Register a spec file in the index. Validates YAML front-matter (requires kind: dbgprobe-protocol and name). The file path can be absolute or relative to CWD.

Full-text search over a spec's content. Returns matching snippets with line numbers and surrounding context.

Return a markdown template for a new debug probe protocol spec. Optionally pre-fill with a device name.

Query target state. Returns whether the target is running or halted, and if halted, the current PC and stop reason (e.g. breakpoint hit).

Single-step one instruction. Target must be halted first. Returns the new PC and stop reason.

Parse an SVD file and attach it to a session. Enables named register reads/writes, field-level access, and auto-decode on mem.read. Re-attaching replaces the previous SVD.

Detailed description of a peripheral, register, or field. Includes description, access type, reset value, and enum values as appropriate.

Get SVD metadata for a session: device name, peripheral count. Returns null if no SVD is attached.

List all fields for a register.

List all peripherals defined in the attached SVD.

List all registers for a peripheral.

Read a register or field by name. For registers (e.g. 'GPIO.OUT'), returns the raw value and all decoded fields. For fields (e.g. 'GPIO.PIN_CNF[3].PULL'), returns just the field value and enum name.

Read-modify-write a single register field. Reads the current register value, modifies the specified field, and writes back. Accepts enum names (e.g. 'PullUp') or integer values.

Batch read-modify-write: update multiple fields in one register with a single read and write. Accepts a dict of field names to values (enum names or integers).

Write a raw value to a full register. No read-modify-write — the entire register is overwritten. For field-level writes, use svd.set_field.

Return tracing config and event count.

Return last N trace events (default 50).