What is Mcp Server Gdb

mcp_server_gdb is a GDB/MI protocol server based on the MCP protocol, designed to provide remote application debugging capabilities.

Use cases

Use cases include debugging applications remotely, managing multiple debugging sessions simultaneously, and analyzing stack frames and local variables during the debugging process.

How to use

To use mcp_server_gdb, install Rust and Cargo, clone the repository, and run ‘cargo run’ to start the server. It supports two transport modes: Stdio (default) and SSE.

Key features

Key features include creating and managing GDB debug sessions, setting and managing breakpoints, viewing stack information and variables, controlling program execution, and supporting concurrent multi-session debugging.

Where to use

mcp_server_gdb can be used in software development environments where remote debugging of applications is required, particularly for applications developed in languages supported by GDB.

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

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