mcpField
M
MCP Server GDB

MCP Server GDB

Local
github.com/pansilaDeveloper Tools68Updated 58w ago

About MCP Server GDB

MCP Server GDB is an MCP server that wraps the GDB/MI protocol, letting AI assistants debug applications remotely. It supports multiple concurrent debug sessions. A built-in TUI for inspecting agent behavior is in progress.

Key features

  1. 01Create and manage GDB debug sessions
  2. 02Set and delete breakpoints
  3. 03Inspect stack frames and local variables
  4. 04Control execution: run, pause, step, next
  5. 05Concurrent multi-session debugging
  6. 06Read registers and memory contents

Use cases

  1. 01Letting an AI assistant debug an application remotely
  2. 02Running parallel debugging sessions for separate issues
  3. 03Examining stack, variables and registers through an AI client

MCP support

This is an MCP server that exposes GDB debugging operations such as create_session, set_breakpoint and get_stack_frames as MCP tools.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
Using Nix

If you have Nix installed, you can run the project without cloning:

Run locally (after cloning)
nix run .
Run remotely from GitHub
nix run "git+https://github.com/pansila/mcp_server_gdb.git" -- --help

Development environment

To enter a development shell with all dependencies:

nix develop

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.