Gdbstub MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/0xmortuex-gdbstub-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools

6 read · 4 write · 2 delete · 7 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (19)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• debug_backtrace

  Show the call stack. mode "fp" walks the frame-pointer chain (exact, but only if the kernel was built with frame pointers, e.g. -fno-omit-frame-pointer); "scan" scans the stack for return addresses (works on -O2 kernels without frame pointers, x86 only, needs elf; may include stale frames); "auto" tries fp and falls back to scan if the chain is empty.

• debug_break

  Set a breakpoint or watchpoint. location: 0x1234, symbol, symbol+0x10, or file.c:42. kind: "sw" (software breakpoint), "hw" (hardware breakpoint - use this before paging is enabled or for code that isn't loaded yet), or a watchpoint: "write", "read", "access" (length bytes, default one word).

• debug_breakpoints

  List breakpoints and watchpoints.

• debug_connect

  Connect to a gdbstub and register the session under `name`. For QEMU, start it with `-s` (stub on tcp::1234) or `-gdb tcp::PORT`, and add `-S` to halt the CPU before the first instruction so you can set breakpoints before anything runs. With qemu-mcp, pass these via qemu_boot's extra_args, e.g. extra_args="-s -S". elf is the kernel image with symbols (and ideally DWARF debug info); it enables symbol names, file:line breakpoints and source locations. load_bias is added to every ELF address, for images loaded somewhere other than their link address (0 for a normally linked kernel). The target s…

• debug_continue

  Resume the target and wait up to timeout_s for it to stop. If it hasn't stopped by then it keeps running: call debug_wait to keep waiting, or debug_interrupt to halt it where it is.

• debug_delete

  Remove a breakpoint/watchpoint by its # id.

• debug_disassemble

  Disassemble `count` instructions from address (default: current pc). bits overrides the decode mode on x86 (16 for real mode, 32, 64) - useful in bootloader code that runs before the CPU mode matches the ELF.

• debug_disconnect

  Remove breakpoints, detach from the stub so the guest keeps running, and forget the session. A running target is halted first.

• debug_explain_fault

  Explain a crash / triple fault from a QEMU interrupt log. Produce the log by running QEMU with `-d int,cpu_reset -D <log_path>` (add `-no-reboot` so a triple fault stops the VM instead of looping). Decodes the exception chain (vector names, page-fault and selector error codes, CR2), filters out timer IRQs and software interrupts, points at the root cause, and symbolizes addresses when elf is given. x86 only.

• debug_interrupt

  Halt a running target immediately (like Ctrl-C in gdb).

• debug_memory

  Read guest memory (virtual addresses, as the CPU currently sees them). address accepts 0x1234, symbol, symbol+0x10, file.c:42 or $esp+8. format: "hex" (hexdump with ASCII), "words" (pointer-sized words, symbolized), or "string" (NUL-terminated string at address). length is capped at 4096 bytes.

• debug_registers

  Read registers. Target must be halted. registers is a comma-separated list (e.g. "eip,esp,cr2,cr3"); default is the general set from the stub's `g` packet. all=True also reads every extra register the target describes (control registers, segment bases, FPU/SSE...). Flag registers (eflags, cr0, cr4...) are decoded.

• debug_sessions

  List active debug sessions.

• debug_set_register

  Write a register. value is an address expression (0x10, symbol, ...).

• debug_step

  Single-step `count` machine instructions (1..1000) and show where it stopped.

Signals

Stars

1

Forks

1

Open issues

0

Weekly downloads

49

Last commit

Oct 11, 2026 (19 days ago)

Last release

Oct 11, 2026 (19 days ago)

Last package publish

Oct 11, 2026 (19 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.0xmortuex/gdbstub-mcp

Version

0.1.0

Auth

No auth

Packages

pypi gdbstub-mcp

License

MIT

Repository

github.com/0xmortuex/gdbstub-mcp

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql