MCP GDB Server

A Model Context Protocol (MCP) server that provides GDB debugging functionality for use with Claude or other AI assistants.

Features

• Start and manage GDB debugging sessions
• Load programs and core dumps for analysis
• Set breakpoints, step through code, and examine memory
• View call stacks, variables, and registers
• Execute arbitrary GDB commands

Installation

# Clone the repository
git clone https://github.com/signal-slot/mcp-gdb.git
cd mcp-gdb

# Install dependencies
npm install

# Build the project
npm run build

Usage

Using with Claude or other MCP-enabled assistants

1. Configure the MCP settings in the Claude desktop app or browser extension to include this server:

{
  "mcpServers": {
    "gdb": {
      "command": "node",
      "args": ["/path/to/mcp-gdb/build/index.js"],
      "disabled": false
    }
  }
}

2. Restart Claude or refresh the page.

3. Now you can use the GDB tools in your conversations with Claude.

Example Commands

Here are some examples of using the GDB MCP server through Claude:

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
• gdb_continue: Continue program execution
• gdb_step: Step program execution
• gdb_next: Step over function calls
• gdb_finish: Execute until the current function returns
• gdb_backtrace: Show call stack
• gdb_print: Print value of expression
• gdb_examine: Examine memory
• gdb_info_registers: Display registers

License

MIT