mcpField
M
mcp-gdbserver

mcp-gdbserver

Local
github.com/daedalusDeveloper Tools0Updated 27w ago
Repository

About mcp-gdbserver

mcp-gdbserver is an MCP server for developers debugging programs remotely with gdbserver. Its tools cover process and session management, execution control, breakpoints, and inspection.

Key features

  1. 01Start, attach, and manage sessions
  2. 02Set and delete breakpoints
  3. 03Continue, step, and interrupt execution
  4. 04Inspect threads, stack, and variables
  5. 05Read registers and memory

Use cases

  1. 01Debug a program through a gdbserver session
  2. 02Pause execution at a breakpoint
  3. 03Inspect stack frames, variables, or memory

MCP support

Exposes 19 debugging tools to MCP clients for managing gdbserver sessions, controlling execution, setting breakpoints, and inspecting program state.

Configuration

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

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-gdbserver": {
      "command": "uvx",
      "args": [
        "mcp-gdbserver"
      ]
    }
  }
}
Run commanduvx mcp-gdbserver

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-gdbserver0.1.1

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-gdbserver

MCP server for remote debugging with gdbserver - provides full debugging capabilities including process management, breakpoint control, stepping, memory inspection, and more.

PyPI Python Coverage Ruff

Install

pip install mcp-gdbserver

Usage

from mcp_gdbserver import GdbDebugger

# Create debugger instance
debugger = GdbDebugger()

# Start gdbserver to debug a program
session = debugger.start_gdbserver(port=2345, program="/bin/myapp", args=["--debug"])

# Get session info
sessions = debugger.list_sessions()

# Stop session
debugger.stop_session("session_1")

CLI

mcp-gdbserver --help

Tools

The MCP server provides 19 debugging tools organized into 4 categories:

Process Management
  • gdbserver_start - Start gdbserver to debug a program remotely
  • gdbserver_start_multi - Start gdbserver in multi-process mode
  • gdbserver_attach - Attach to a running process
  • gdbserver_list_sessions - List all active sessions
  • gdbserver_stop - Stop a debugging session
Breakpoint Control
  • gdbserver_set_breakpoint - Set a breakpoint at a location
  • gdbserver_delete_breakpoint - Delete a breakpoint
Execution Control
  • gdbserver_continue - Continue execution
  • gdbserver_step - Step one instruction (into functions)
  • gdbserver_next - Execute one instruction (over functions)
  • gdbserver_interrupt - Interrupt execution
Inspection
  • gdbserver_stack_frames - Get call stack frames
  • gdbserver_local_variables - Get local variables
  • gdbserver_list_threads - List all threads
  • gdbserver_select_thread - Switch to a thread
  • gdbserver_read_register - Read CPU registers
  • gdbserver_read_memory - Read memory contents
  • gdbserver_evaluate - Evaluate an expression
  • gdbserver_load_symbols - Load symbol file

MCP Configuration

Add to your MCP config:

{
  "mcpServers": {
    "mcp-gdbserver": {
      "command": "mcp-gdbserver",
      "env": {}
    }
  }
}

Development

git clone https://github.com/daedalus/mcp-gdbserver.git
cd mcp-gdbserver
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

mcp-name: io.github.daedalus/mcp-gdbserver

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.