embedded-gdb-mcp

A Model Context Protocol (MCP) server that provides GDB debugging functionality, built with Rust for embedded development workflows.

Features

• Start and manage GDB debugging sessions

• Load programs and core dumps for analysis

• Set breakpoints with conditional support

• Step through code (line by line or instruction by instruction)

• Examine memory, registers, and variables

• View call stacks and source code with VS Code integration

• Execute arbitrary GDB commands

• Attach to running processes

• Pre-built binaries for Windows, macOS, and Linux (x64 & arm64)

Installation

Claude Code

claude mcp add embedded-gdb-debugger -- npx -y @vividcodeai/embedded-gdb-mcp

Claude Desktop

Add the following to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "embedded-gdb-debugger": {
      "command": "npx",
      "args": ["-y", "@vividcodeai/embedded-gdb-mcp"]
    }
  }
}

Install from Source

git clone https://github.com/vividcode-ai/embedded-gdb-mcp.git
cd embedded-gdb-mcp
cargo build --release

The binary will be available at target/release/embedded-gdb-mcp.

Usage

Example Commands

Starting a GDB session

Use gdb_start to start a new debugging session

Loading a program

Use gdb_load to load /path/to/my/program with the sessionId that was returned from gdb_start

Setting a breakpoint

Use gdb_set_breakpoint to set a breakpoint at main in the active GDB session

Running the program

Use gdb_continue to start execution

Examining variables

Use gdb_print to evaluate the expression "my_variable" in the current context

Getting a backtrace

Use gdb_backtrace to see the current call stack

Terminating the session

Use gdb_terminate to end the debugging session

Supported GDB Commands

• gdb_start: Start a new GDB session

• gdb_load: Load a program into GDB

• gdb_command: Execute an arbitrary GDB command

• gdb_terminate: Terminate a GDB session

• gdb_list_sessions: List all active GDB sessions

• gdb_attach: Attach to a running process

• gdb_load_core: Load a core dump file

• gdb_set_breakpoint: Set a breakpoint (with optional condition)

• gdb_continue: Continue program execution

• gdb_step: Step program execution (line or instruction)

• gdb_next: Step over function calls (line or instruction)

• gdb_finish: Execute until the current function returns

• gdb_backtrace: Show call stack (with optional full mode and frame limit)

• gdb_print: Print value of expression

• gdb_examine: Examine memory (with format and count options)

• gdb_info_registers: Display registers (optionally for a specific register)

• gdb_list_source: List source code at current or specified location with VS Code integration

License

MIT

中文文档