This MCP server enables AI assistants to perform comprehensive GDB debugging operations through a structured interface.
Session Management: Start new GDB sessions with custom GDB paths and working directories, list active sessions, and terminate sessions
Program Loading: Load executables with command-line arguments, attach to running processes by PID, and load core dump files for post-mortem analysis
Execution Control: Continue execution, step into/over functions, step by source lines or instructions, and finish executing the current function
Breakpoint Control: Set breakpoints at specific locations (functions, file:line) with optional conditions
Code & State Inspection: View call stacks with optional frame limits and variable display, list source code at current or specified locations with VS Code integration, print variable values and evaluate expressions, examine memory at specific addresses with customizable display formats (hex, instruction, etc.), and display CPU registers
Raw Command Execution: Execute arbitrary GDB commands for advanced debugging scenarios
Allows accessing the MCP GDB server repository for installation and setup.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP GDB Serverset a breakpoint at main and then run the program"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
View source code with VS Code integration
Execute arbitrary GDB commands
Related MCP server: GCP MCP
Installation
Claude Code
Claude Desktop
Add the following to your Claude Desktop MCP configuration:
Install from Source
Usage
Example Commands
Here are some examples of using the GDB MCP server through Claude:
Starting a GDB session
Loading a program
Setting a breakpoint
Running the program
Examining variables
Getting a backtrace
Terminating the session
Supported GDB Commands
gdb_start: Start a new GDB sessiongdb_load: Load a program into GDBgdb_command: Execute an arbitrary GDB commandgdb_terminate: Terminate a GDB sessiongdb_list_sessions: List all active GDB sessionsgdb_attach: Attach to a running processgdb_load_core: Load a core dump filegdb_set_breakpoint: Set a breakpointgdb_continue: Continue program executiongdb_step: Step program executiongdb_next: Step over function callsgdb_finish: Execute until the current function returnsgdb_backtrace: Show call stackgdb_print: Print value of expressiongdb_examine: Examine memorygdb_info_registers: Display registersgdb_list_source: List source code at current location or specified location with VS Code integration
License
MIT