GDB MCP Server

@smadi0x86

About GDB MCP Server

Multi Debugger MCP server that enables LLMs to interact with GDB and LLDB for binary debugging and analysis.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "GDB-MCP": {
      "command": "python3",
      "args": [
        "gdb-mcp.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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`: ```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.

Comments

Basic information

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K