mcpField
D
dbgmcp

dbgmcp

Local
github.com/ramenhostDeveloper Tools10Updated 77w ago
Repository

About dbgmcp

dbgmcp is a set of MCP servers connecting LLM agents to GDB, LLDB, and PDB. Each debugger has a separate server that can be enabled as needed, with support for loading programs and running debugger commands.

Key features

  1. 01Supports GDB, LLDB, and PDB
  2. 02Separate server for each debugger
  3. 03Load programs into debuggers
  4. 04Run debugger commands
  5. 05Supports multiple simultaneous connections

Use cases

  1. 01Let an agent inspect program state
  2. 02Investigate faults with debugger commands
  3. 03Connect only the needed debuggers

MCP support

dbgmcp provides MCP servers for GDB, LLDB, and PDB, exposing program loading and debugger command execution to MCP clients. The README cautions that agents can run arbitrary commands, including shell commands, inside debuggers.

#pdb#gdb#lldb#mcp-server#model-context-protocol-servers

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

GitHub release (latest by date) Follow @ramenhost

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": []
    }
  }
}
  1. 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": []
        }
    }
}
  1. Restart VS Code or reload the window.
  2. 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.