English Français العربية

GDB

Community Developer tools

A GDB/MI protocol server based on the MCP protocol, providing remote application debugging capabilities with AI assistants.

Source code Documentation

What can you do with GDB?

  • Create and manage GDB debug sessions
  • Set and manage breakpoints
  • View stack information and variables
  • Control program execution (run, pause, step, etc.)
  • Support concurrent multi-session debugging
  • A built-in TUI to inspect agent behaviors so that you can improve your prompt (WIP)

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MCP Server GDB
  2. Features
  3. Installation
  4. Usage
  5. Configuration
  6. Supported MCP Tools
  7. License

MCP Server GDB

A GDB/MI protocol server based on the MCP protocol, providing remote application debugging capabilities with AI assistants.

Features

  • Create and manage GDB debug sessions
  • Set and manage breakpoints
  • View stack information and variables
  • Control program execution (run, pause, step, etc.)
  • Support concurrent multi-session debugging
  • A built-in TUI to inspect agent behaviors so that you can improve your prompt (WIP)

Installation

Pre-built Binaries

Find the binaries in the release page, choose one per your working platform, then you can run it directly.

Build From Source

Clone the repository and build it by cargo

cargo build --release
cargo run
Using Nix

If you have Nix installed, you can run the project without cloning:

Run locally (after cloning)
nix run .
Run remotely from GitHub
nix run "git+https://github.com/pansila/mcp_server_gdb.git" -- --help
Development environment

To enter a development shell with all dependencies:

nix develop

Usage

  1. Just run it directly: ./mcp-server-gdb
  2. The server supports two transport modes:
    • Stdio (default): Standard input/output transport
    • SSE: Server-Sent Events transport, default at http://127.0.0.1:8080

Configuration

You can adjust server configuration by modifying the src/config.rs file or by environment variables:

  • Server IP Address
  • Server port
  • GDB command timeout time (in seconds)

Supported MCP Tools

Session Management
  • create_session - Create a new GDB debugging session
  • get_session - Get specific session information
  • get_all_sessions - Get all sessions
  • close_session - Close session
Debug Control
  • start_debugging - Start debugging
  • stop_debugging - Stop debugging
  • continue_execution - Continue execution
  • step_execution - Step into next line
  • next_execution - Step over next line
Breakpoint Management
  • get_breakpoints - Get breakpoint list
  • set_breakpoint - Set breakpoint
  • delete_breakpoint - Delete breakpoint
Debug Information
  • get_stack_frames - Get stack frame information
  • get_local_variables - Get local variables
  • get_registers - Get registers
  • read_memory - Read memory contents

License

MIT

Frequently asked questions

What is GDB?

A GDB/MI protocol server based on the MCP protocol, providing remote application debugging capabilities with AI assistants.

How do I install GDB?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is GDB open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains GDB?

It is published by pansila. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.