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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →