Skip to main content
Glama

gdbmcp

GDB MCP server.

Overview

gdbmcp exposes GDB operations over the MCP (Model Context Protocol) using FastMCP. It manages GDB sessions over a socket connection (via gdbrpc) and provides MCP tools to connect, list, terminate sessions, and run GDB commands.

Related MCP server: dap-mcp

Features

  • Start and manage multiple GDB sessions

  • Execute arbitrary GDB commands through MCP

  • Run as MCP stdio server or HTTP server

Requirements

  • Python >= 3.10

  • gdbrpc

  • mcp

  • HTTP mode only: uvicorn (required to run the HTTP server)

Installation

From PyPI:

pip install gdbmcp-server

From repo root:

pip install .

For development:

pip install -e .

Usage

Run MCP server (stdio)

python -m gdbmcp-server gdbmcp --stdio

Run MCP server (HTTP)

python -m gdbmcp-server

MCP Tools

gdb_connect(host: Optional[str] = None, port: Optional[int] = None) -> str

Establish a GDB session and returns a session ID.

gdb_terminate(session_id: str) -> str

Terminate an existing session and clean up resources.

gdb_list_sessions() -> str

List all active sessions and their host/port.

gdb_command(session_id: str, command: str) -> str

Execute a GDB command in the session and return output.

Configuration

CLI flags:

  • --stdio : Run in stdio transport mode

  • --port : HTTP server port (default: 20819)

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    An implementation of the Model Context Protocol (MCP) that enables interaction with debug adapters, allowing language models to control debuggers, set breakpoints, evaluate expressions, and navigate source code during debugging sessions.
    40
    AGPL 3.0
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables dynamic debugging with GDB via the MCP protocol, allowing LLMs to execute GDB commands, manage breakpoints, control execution, and inspect program state.
    4
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to interact with GDB for debugging via the MCP protocol. Supports setting breakpoints, stepping through code, inspecting memory and registers, and more.
    85
    MIT