GDB MCP Server

Name: GDB MCP Server
Author: smadi0x86

@smadi0x86

Repository

About GDB MCP Server

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

#gdb #debugging #mcp-server

Basic information

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.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K