dap_mcp

Overview

dap-mcp is a Python implementation of the Model Context Protocol that bridges large language models with debug adapters. It provides a set of tools for controlling debugging sessions, including setting and removing breakpoints, controlling execution flow (continue, step in/out/next), evaluating expressions, changing stack frames, and viewing source code. The server supports multiple debug adapters like debugpy and lldb through a flexible JSON configuration system, making it adaptable to various debugging environments.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• launch

  Launch the debuggee program.

  Try:Start debugging the Python applicationTry:Launch the debugger with my configuration
• set_breakpoint

  Set a breakpoint at a specified file and line (with an optional condition).

  Try:Set a breakpoint at line 42 in main.pyTry:Create a breakpoint in utils.py at line 15
• remove_breakpoint

  Remove a breakpoint from a specified file and line.

  Try:Remove the breakpoint at line 42Try:Clear all breakpoints from main.py
• list_all_breakpoints

  List all breakpoints currently set in the debugger.

  Try:Show me all breakpointsTry:List current breakpoints
• continue_execution

  Continue program execution after hitting a breakpoint.

  Try:Resume executionTry:Continue debugging
• step_in

  Step into a function call.

  Try:Step into this functionTry:Go inside the called method
• step_out

  Step out of the current function.

  Try:Step out of this functionTry:Return from current method
• next

  Step over to the next line of code.

  Try:Go to next lineTry:Execute next line
• evaluate

  Evaluate an expression in the current debugging context.

  Try:Evaluate variable xTry:Check the value of this expression
• change_frame

  Switch to a different stack frame.

  Try:Switch to the previous frameTry:Move to caller frame
• view_file_around_line

  View source code around a specified line.

  Try:Show code around line 42Try:Display source near breakpoint
• terminate

  Terminate the debugging session.

  Try:Stop debuggingTry:End the session

Comparable tools

Installation

{
  "mcpServers": {
    "dap-debugger": {
      "command": "python",
      "args": ["-m", "dap_mcp"],
      "env": {
        "DAP_MCP_CONFIG": "/path/to/config.json"
      }
    }
  }
}

FAQ

What debuggers are supported by dap-mcp?

Currently, dap-mcp supports debugpy and lldb through the Debug Adapter Protocol. The architecture is designed to be extensible, allowing for additional debugger support by creating new configuration classes.

How do I add support for a new debugger?

To add support for a new DAP server, create a new configuration class in `dap_mcp/config.py` that extends the base `DAPConfig` class. Define a unique type value and any additional settings specific to that debugger, then update the union type for debugger-specific configurations.

Compare dap_mcp with