What is Mcp Gdb

mcp-gdb is a Model Context Protocol (MCP) server that provides GDB debugging functionality for AI assistants like Claude.

Use cases

Use cases include debugging applications, analyzing core dumps, setting breakpoints during development, and interacting with GDB commands through AI assistants.

How to use

To use mcp-gdb, configure the MCP settings in the Claude app or browser extension to include the server, restart Claude, and then utilize GDB commands in your conversations.

Key features

Key features include starting and managing GDB sessions, loading programs and core dumps, setting breakpoints, stepping through code, examining memory, and executing arbitrary GDB commands.

Where to use

mcp-gdb can be used in software development environments where GDB debugging is required, particularly in projects involving AI assistants.

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