MCP Server GDB

What is MCP Server GDB?

MCP Server GDB is a server that implements the Model Context Protocol to expose GDB/MI debugging capabilities to AI assistants. It allows remote debugging of applications by creating and managing GDB debug sessions, setting breakpoints, inspecting stack frames and variables, and controlling program execution, with support for concurrent multi-session debugging and a built-in TUI for inspecting agent behaviors.

How to use MCP Server GDB?

Install by downloading a pre-built binary from the release page, building from source with cargo build --release then cargo run, or using Nix (run locally with nix run ., remotely with nix run "git+https://github.com/pansila/mcp_server_gdb.git" -- --help). Run directly with ./mcp-server-gdb. Two transport modes are available: Stdio (default) and SSE at http://127.0.0.1:8080. Configuration can be adjusted by modifying src/config.rs or via environment variables for server IP address, port, and GDB command timeout.

Key features of MCP Server 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
• Built-in TUI to inspect agent behaviors

Use cases of MCP Server GDB

• AI‑assisted remote debugging of applications
• Debugging multiple programs simultaneously with concurrent sessions
• Inspecting debugger state via MCP tools from an AI assistant
• Integrating GDB debugging capabilities into MCP‑aware environments

FAQ from MCP Server GDB

What transport modes are supported?

Stdio (default) and SSE (Server‑Sent Events) at http://127.0.0.1:8080.

How do I configure the server?

Modify src/config.rs or set environment variables for server IP address, server port, and GDB command timeout (in seconds).

What are the system dependencies?

The server communicates using the GDB/MI protocol, so GDB must be installed on the system.

How do I install from source?

Clone the repository and run cargo build --release, then cargo run. Alternatively, use nix run . after cloning or nix run "git+https://github.com/pansila/mcp_server_gdb.git" -- --help remotely.

Is multi-session debugging supported?

Yes, concurrent multi-session debugging is supported, allowing multiple independent debug sessions to run simultaneously.