GDB MCP Server

What is GDB MCP Server?

A Model Context Protocol server that provides debugging functionality for both GDB and LLDB debuggers, for use with Claude Desktop, VSCode Copilot, or other AI assistants.

How to use GDB MCP Server?

Clone the repository, then run uv sync, uv venv, and uv run server.py to start the server. Configure your MCP client (e.g., Claude Desktop, VSCode, Windsurf) by adding the appropriate JSON configuration pointing to the server script.

Key features of GDB MCP Server

• Unified tools for both GDB and LLDB.
• Auto-detection of available debuggers.
• Execute arbitrary debugger commands.
• Experimental LLDB support on macOS.
• Session management (start, terminate, list).
• Integrates with Claude Desktop, VSCode, Windsurf.

Use cases of GDB MCP Server

• Debugging executables using an AI assistant.
• Controlling GDB or LLDB sessions via natural language.
• Cross-platform debugging (GDB on Linux, LLDB on macOS).
• Running debugger commands without manual terminal input.

FAQ from GDB MCP Server

What debuggers does GDB MCP Server support?

The server supports both GDB and LLDB debuggers, with automatic debugger selection.

How do I install GDB MCP Server?

Run uv sync, uv venv, then uv run server.py in the project directory.

How do I integrate GDB MCP Server with Claude Desktop?

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "gdb": {
      "command": "uv",
      "args": ["run", "/path/to/server.py"],
      "disabled": false
    }
  }
}

Is LLDB support stable?

LLDB support is experimental and currently only available on macOS.

What tools are available?

Unified tools: debugger_status, debugger_start, debugger_terminate, debugger_list_sessions, debugger_command. Also separate LLDB and GDB tool sets.