GDB

What is mcp_server_gdb?

mcp_server_gdb is a GDB/MI protocol server built on the MCP protocol. It provides remote application debugging capabilities, enhanced with AI assistants, allowing developers to debug applications remotely.

How to use mcp_server_gdb?

To use mcp_server_gdb, you can either download pre-built binaries from the release page or build it from source using cargo build --release and cargo run. Once built, simply run ./mcp-server-gdb. The server supports two transport modes: Stdio (default) and SSE (Server-Sent Events) at http://127.0.0.1:8080. You can configure the server's IP address, port, and GDB command timeout by modifying src/config.rs or using environment variables.

Key Features of mcp_server_gdb

• Session Management: Create, get, and close GDB debug sessions.
• Debug Control: Start, stop, continue, step into, and step over program execution.
• Breakpoint Management: Set, get, and delete breakpoints.
• Debug Information: Retrieve stack frame information, local variables, registers, and read memory contents.
• Concurrent Multi-session Debugging: Supports debugging multiple sessions simultaneously.
• AI Assistant Integration: Provides remote application debugging capabilities with AI assistants.
• Built-in TUI (WIP): A work-in-progress Text User Interface to inspect agent behaviors for prompt improvement.

Use Cases of mcp_server_gdb

mcp_server_gdb is ideal for developers who need to:

• Remotely debug applications using the GDB/MI protocol.
• Manage multiple debugging sessions concurrently.
• Leverage AI assistants for enhanced debugging workflows.
• Control program execution and inspect debug information efficiently.

FAQ about mcp_server_gdb

Q: What is the MCP protocol? A: The MCP protocol is the underlying communication protocol used by mcp_server_gdb to expose GDB debugging capabilities.

Q: How can I configure the server? A: You can configure the server by modifying the src/config.rs file or by setting environment variables for server IP address, port, and GDB command timeout.

Q: Does it support concurrent debugging? A: Yes, mcp_server_gdb supports concurrent multi-session debugging.

Q: What kind of AI assistant features are available? A: The project provides remote application debugging capabilities with AI assistants, and there's a built-in TUI (WIP) to inspect agent behaviors for prompt improvement.

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