Pansila MCP Server Gdb

🚀 MCP Debug Server GDB

A GDB/MI protocol server based on the MCP protocol, providing remote application debugging capabilities and integrating an AI assistant.

🚀 Quick Start

The MCP Debug Server GDB is a powerful tool for debugging remote applications. It offers a range of features to enhance the debugging experience.

✨ Features

• Create and manage GDB debugging sessions.
• Set and manage breakpoints.
• View stack information and variables.
• Control program execution (run, pause, step-by-step debugging, etc.).
• Support concurrent debugging of multiple sessions.

📦 Installation

Pre-compiled Binaries

Visit the release page to obtain the binary files for your platform. After downloading, you can run them directly.

Build from Source

Clone the repository and build it using cargo:

cargo build --release
cargo run

💻 Usage Examples

Basic Usage

# Run the program directly
./mcp-server-gdb

The server supports two transmission modes:

• Standard input/output (default): stdio
• Server-Sent Events (SSE, default address: http://127.0.0.1:8080)

📚 Documentation

Configuration

Adjust the server configuration by modifying the src/config.rs file or setting environment variables:

• Server IP address
• Server port
• GDB command timeout (seconds)

Supported MCP Tools

Session Management

• create_session - Create a new GDB debugging session.
• get_session - Get information about a specific session.
• get_all_sessions - Get all sessions.
• close_session - Close a session.

Debugging Control

• start_debugging - Start debugging.
• stop_debugging - Stop debugging.
• continue_execution - Continue execution.
• step_execution - Step into the next line.
• next_execution - Step over the next line.

Breakpoint Management

• get_breakpoints - Get the list of breakpoints.
• set_breakpoint - Set a breakpoint.
• delete_breakpoint - Delete a breakpoint.

Debugging Information

• get_stack_frames - Get stack frame information.
• get_local_variables - Get local variables.
• get_registers - Get registers.
• read_memory - Read memory content.