Skip to content

Releases: FlorentinoJink/mcp-gdb

0.1.0

07 Apr 08:53
@FlorentinoJink FlorentinoJink
0.1.0
1eb8c46

Choose a tag to compare

View all tags
0.1.0 Latest
Latest

MCP GDB v0.1.0 🎉

First release of the high-performance Rust implementation of MCP GDB server for Linux debugging — core dump analysis, remote debugging, and direct program debugging.

🚀 Features

Core Functionality

  • Core Dump Analysis: Open and analyze Linux core dump files with backtrace, threads, and shared library info
  • Remote Debugging: Connect to gdbserver targets via host:port
  • Direct Program Debugging: Launch executables under GDB, set breakpoints, step through code, inspect variables
  • Custom Commands: Execute arbitrary GDB commands in active sessions
  • Session Management: Automatic session pooling, reuse, and lifecycle management
  • Core Dump Discovery: Search and list core dump files in directories (supports core, core.*, *.core patterns)

Available Tools

  • open_gdb_core — Analyze core dump files with optional backtrace, threads, and shared libraries
  • open_gdb_remote — Connect to gdbserver remote targets
  • launch_debug — Launch programs under GDB for interactive debugging
  • run_gdb_cmd — Execute custom GDB commands in any session
  • close_gdb_core — Close core dump sessions
  • close_gdb_remote — Close remote debugging sessions
  • close_debug — Close launch debug sessions and terminate target program
  • list_core_dumps — List available core dumps in directories

Technical Highlights

  • ✅ High Performance: Native Rust implementation with Tokio async runtime
  • ✅ Memory Safe: Compile-time memory safety guarantees
  • ✅ Single Binary: Statically linked (musl), no runtime dependencies
  • ✅ MCP Protocol: Full Model Context Protocol support via stdio transport
  • ✅ Session Pooling: Automatic GDB session reuse and management
  • ✅ Configurable Timeouts: Separate init timeout (symbol loading) and command timeout
  • ✅ Debuginfod Control: --disable-debuginfod to prevent network symbol downloads
  • ✅ Stripped Binary Support: debug_info_directory and sysroot for separated debug info
  • ✅ ptrace Detection: Pre-launch checks with clear error messages for containers/VMs

📦 Installation

Download Binary

Download mcp-gdb from the release assets. Statically linked, works on any x86_64 Linux.

chmod +x mcp-gdb```

**Build from Source**

```bash
git clone https://github.com/FlorentinoJink/mcp-gdb.git
cd mcp-gdb
cargo build --release

🔧 Configuration

{
  "mcpServers": {
    "mcp-gdb": {
      "command": "/path/to/mcp-gdb",
      "args": []
    }
  }
}

📋 Requirements

  • Linux x86_64
  • GDB (apt install gdb / dnf install gdb / pacman -S gdb)
Assets 3
Loading