What is Dbgmcp

dbgmcp is a collection of MCP servers designed to connect various debuggers to AI agents using the Model Context Protocol. It supports GDB, LLDB, and PDB debuggers.

Use cases

Use cases for dbgmcp include debugging AI applications, integrating debugging tools with AI agents for enhanced analysis, and facilitating complex debugging scenarios in development workflows.

How to use

To use dbgmcp, install the appropriate pre-built binary for your platform or build from source using Rust and Cargo. Configure the MCP servers in the relevant application settings, such as Claude Desktop.

Key features

Key features include separate servers for each debugger, the ability to load programs, execute arbitrary commands, and support for multiple simultaneous connections.

Where to use

dbgmcp can be used in software development environments, particularly for debugging applications that utilize AI agents, enhancing the debugging process with advanced capabilities.

dbgmcp

A collection of MCP servers to connect various debuggers to LLM agents using Model Context Protocol.
Supported debuggers include:

• GDB (GNU Debugger)
• LLDB (LLVM Debugger)
• PDB (Python Debugger)

https://github.com/user-attachments/assets/fa745e69-2bd9-482c-b5f1-59b42e458760

Features

• Separate servers for each debugger. Enable or disable them as needed.
• Load programs into the debugger.
• Execute arbitrary commands in the debugger.
• Supports multiple simultaneous connections.

[!CAUTION]
AI agents can execute arbitrary commands inside debuggers, including shell commands. Use at your own risk.

Installation

Simple way is to pick a pre-built binary for your platform from the releases page.
Currently, pre-built binaries are available for the following platforms:

• Linux x86_64 (x86_64-unknown-linux-musl)

The binaries are named according to the debugger they support:

• gdb-mcp
• lldb-mcp
• pdb-mcp.

If pre-built binaries are not available for your platform, you can build the project from source.

Building from source

Requires Rust and Cargo to be installed. You can install them using rustup.

git clone https://github.com/ramenhost/dbgmcp
cd dbgmcp

cargo build --release

This will create MCP server binaries in target/release/ folder.

Usage

Claude Desktop

1. Open the Claude desktop settings. Click on “Developer” in the left-hand bar of the settings pane, and then click on “Edit Config”. The will create a claude_desktop_config.json file and display it in filesystem.
2. Add required MCP servers to the claude_desktop_config.json. Below configuration includes all debuggers in Claude (GDB, LLDB and PDB). You can include only the servers you need.

{
  "mcpServers": {
    "gdb": {
      "command": "/path/to/gdb-mcp",
      "args": []
    },
    "lldb": {
      "command": "/path/to/lldb-mcp",
      "args": []
    },
    "pdb": {
      "command": "/path/to/pdb-mcp",
      "args": []
    }
  }
}

3. Restart Claude or refresh the page.

For more details, see Claude docs.

VS Code Github Copilot

1. Enable MCP support in VS Code settings. To enable MCP support in VS Code, enable the chat.mcp.enabled setting.
2. Create a .vscode/mcp.json file in your workspace.
3. Add required MCP servers to the mcp.json file. Below configuration includes all debuggers in VS Code (GDB, LLDB and PDB). You can include only the servers you need.

{
  "servers": {
    "gdb": {
      "type": "stdio",
      "command": "/path/to/gdb-mcp",
      "args": []
    },
    "lldb": {
      "type": "stdio",
      "command": "/path/to/lldb-mcp",
      "args": []
    },
    "pdb": {
      "type": "stdio",
      "command": "/path/to/pdb-mcp",
      "args": []
    }
  }
}

4. Restart VS Code or reload the window.
5. Now, the debugger tools are avilable in Agent mode of Github Copilot chat.

For more details, see VS Code docs.

Credits

• GDB functionality is rust rewrite of mcp-gdb