Summary
This server wraps gdbserver to give you remote debugging control through MCP tools. You get 19 operations across process management (start, attach, stop sessions), breakpoint handling, execution control (continue, step, next, interrupt), and inspection (stack frames, variables, threads, registers, memory reads). It's what you'd reach for when you want Claude to help debug a running process or step through program execution, whether you're troubleshooting a crash, analyzing memory corruption, or just need an AI pair programmer that can actually inspect your program state. Requires gdbserver on your system and connects via stdio transport.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →mcp-gdbserver
MCP server for remote debugging with gdbserver - provides full debugging capabilities including process management, breakpoint control, stepping, memory inspection, and more.
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 remotelygdbserver_start_multi- Start gdbserver in multi-process modegdbserver_attach- Attach to a running processgdbserver_list_sessions- List all active sessionsgdbserver_stop- Stop a debugging session
Breakpoint Control
gdbserver_set_breakpoint- Set a breakpoint at a locationgdbserver_delete_breakpoint- Delete a breakpoint
Execution Control
gdbserver_continue- Continue executiongdbserver_step- Step one instruction (into functions)gdbserver_next- Execute one instruction (over functions)gdbserver_interrupt- Interrupt execution
Inspection
gdbserver_stack_frames- Get call stack framesgdbserver_local_variables- Get local variablesgdbserver_list_threads- List all threadsgdbserver_select_thread- Switch to a threadgdbserver_read_register- Read CPU registersgdbserver_read_memory- Read memory contentsgdbserver_evaluate- Evaluate an expressiongdbserver_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
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →