{
  "markdown": "# mcp-gdbserver\n\nMCP server for remote debugging with gdbserver - provides full debugging capabilities including process management, breakpoint control, stepping, memory inspection, and more.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-gdbserver.svg)](https://pypi.org/project/mcp-gdbserver/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-gdbserver.svg)](https://pypi.org/project/mcp-gdbserver/)\n[![Coverage](https://codecov.io/gh/daedalus/mcp-gdbserver/branch/main/graph/badge.svg)](https://codecov.io/gh/daedalus/mcp-gdbserver)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\n## Install\n\n```bash\npip install mcp-gdbserver\n```\n\n## Usage\n\n```python\nfrom mcp_gdbserver import GdbDebugger\n\n# Create debugger instance\ndebugger = GdbDebugger()\n\n# Start gdbserver to debug a program\nsession = debugger.start_gdbserver(port=2345, program=\"/bin/myapp\", args=[\"--debug\"])\n\n# Get session info\nsessions = debugger.list_sessions()\n\n# Stop session\ndebugger.stop_session(\"session_1\")\n```\n\n## CLI\n\n```bash\nmcp-gdbserver --help\n```\n\n## Tools\n\nThe MCP server provides 19 debugging tools organized into 4 categories:\n\n### Process Management\n- `gdbserver_start` - Start gdbserver to debug a program remotely\n- `gdbserver_start_multi` - Start gdbserver in multi-process mode\n- `gdbserver_attach` - Attach to a running process\n- `gdbserver_list_sessions` - List all active sessions\n- `gdbserver_stop` - Stop a debugging session\n\n### Breakpoint Control\n- `gdbserver_set_breakpoint` - Set a breakpoint at a location\n- `gdbserver_delete_breakpoint` - Delete a breakpoint\n\n### Execution Control\n- `gdbserver_continue` - Continue execution\n- `gdbserver_step` - Step one instruction (into functions)\n- `gdbserver_next` - Execute one instruction (over functions)\n- `gdbserver_interrupt` - Interrupt execution\n\n### Inspection\n- `gdbserver_stack_frames` - Get call stack frames\n- `gdbserver_local_variables` - Get local variables\n- `gdbserver_list_threads` - List all threads\n- `gdbserver_select_thread` - Switch to a thread\n- `gdbserver_read_register` - Read CPU registers\n- `gdbserver_read_memory` - Read memory contents\n- `gdbserver_evaluate` - Evaluate an expression\n- `gdbserver_load_symbols` - Load symbol file\n\n## MCP Configuration\n\nAdd to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-gdbserver\": {\n      \"command\": \"mcp-gdbserver\",\n      \"env\": {}\n    }\n  }\n}\n```\n\n## Development\n\n```bash\ngit clone https://github.com/daedalus/mcp-gdbserver.git\ncd mcp-gdbserver\npip install -e \".[test]\"\n\n# run tests\npytest\n\n# format\nruff format src/ tests/\n\n# lint\nruff check src/ tests/\n\n# type check\nmypy src/\n```\n\nmcp-name: io.github.daedalus/mcp-gdbserver",
  "bytes": 2750,
  "sha": "256447c37638dd7975aac20c2a7e1ce840f6564a275459df6b9392f142f5795a",
  "repo_slug": "daedalus/mcp-gdbserver",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_gdbserver_12dfdf67/readme"
}