dbgmcp

What is dbgmcp?

dbgmcp is a collection of MCP servers that connect debuggers (GDB, LLDB, and PDB) to LLM agents using the Model Context Protocol. It allows AI agents to interact with debuggers directly.

How to use dbgmcp?

Download a pre‑built binary for your platform from the releases page, or build from source with Rust and Cargo. Configure the server in your MCP client (e.g., Claude Desktop or VS Code) by adding the appropriate binary path and arguments to the client’s configuration file.

Key features of dbgmcp

• Separate MCP servers for GDB, LLDB, and PDB.
• Load programs into the debugger.
• Execute arbitrary debugger commands.
• Supports multiple simultaneous connections.
• Pre‑built binaries available for Linux x86_64.

Use cases of dbgmcp

• Debugging C/C++ programs with an LLM agent via GDB.
• Debugging native code on macOS/Linux with LLDB.
• Debugging Python scripts interactively with PDB.
• Enabling debugger control inside Claude Desktop or VS Code Copilot.

FAQ from dbgmcp

What debuggers does dbgmcp support?

GDB (GNU Debugger), LLDB (LLVM Debugger), and PDB (Python Debugger). Each has its own MCP server binary.

How do I install dbgmcp if there is no pre‑built binary for my platform?

You can build from source. Requires Rust and Cargo (install via rustup), then clone the repo and run cargo build --release.

How do I configure dbgmcp in Claude Desktop?

Add the server definitions to claude_desktop_config.json, specifying the full path to the binary (e.g., /path/to/gdb-mcp) under mcpServers, then restart Claude.

How do I configure dbgmcp in VS Code with GitHub Copilot?

Enable chat.mcp.enabled in VS Code settings, create .vscode/mcp.json in your workspace, and add the server entries with "type": "stdio" and the binary path. Restart VS Code to use the debugger tools in Agent mode.

What are the risks of using dbgmcp?

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