GDB

GDB

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

54
Stars
9
Forks
4
Releases

Overview

MCP Server GDB is a GDB/MI protocol server implemented on the MCP protocol to enable remote debugging of applications with AI-assisted capabilities. It supports creating and managing multiple GDB debugging sessions, retrieving individual session information, listing all sessions, and closing sessions. Debug control commands allow starting and stopping debugging, continuing execution, and performing step-wise or next-line execution. Breakpoint management lets you get, set, and delete breakpoints, while debug information endpoints provide access to stack frames, local variables, registers, and memory contents. The server offers two transport modes: stdio (default) and Server-Sent Events (SSE), with SSE typically available at http://127.0.0.1:8080. Configuration can be adjusted via the src/config.rs file or environment variables, covering server IP address, port, and GDB command timeout. Build and run instructions are cargo build --release followed by cargo run, with optional Nix-based run methods and a development shell (nix develop). Aimed at developers needing remote GDB debugging via MCP with AI assistants; a built-in TUI (Work In Progress) lets you inspect agent behaviors to improve prompts.

Details

Owner
pansila
Language
Rust
License
MIT License
Updated
2025-12-07

Features

Session Management

Create and manage GDB debug sessions (create_session, get_session, get_all_sessions, close_session).

Breakpoint Management

Get, set, and delete breakpoints within GDB debugging sessions.

Debug Control

Control program execution including start, stop, continue, step and next.

Debug Information

Access stack frames, local variables, registers, and memory contents.

Transport Modes

Supports two transports: stdio (default) and SSE (default at http://127.0.0.1:8080).

Concurrent Multi-Session Debugging

Supports concurrent debugging across multiple sessions.

Built-in TUI (WIP)

A TUI to inspect agent behaviors for prompting improvements (Work In Progress).

Tags

MCPGDB/MIdebugging serverremote debuggingAI assistantsmulti-sessionbreakpointsstack framestransportsstdioSSE