MCP Dap Server

🚀 MCP DAP Server

MCP DAP Server 是一个基于模型上下文协议（MCP）的服务器，它通过调试适配器协议（DAP）提供调试功能。该服务器允许 AI 助手和其他 MCP 客户端与各种编程语言的调试器进行交互。

🚀 快速开始

MCP DAP Server 充当 MCP 客户端和支持 DAP 的调试器之间的桥梁，允许以编程方式控制调试会话。它提供了一套全面的调试工具，可用于：

• 启动和停止调试会话
• 设置断点（基于行和基于函数）
• 控制程序执行（继续、单步进入/跳出/越过、暂停）
• 检查程序状态（线程、堆栈跟踪、变量、作用域）
• 计算表达式
• 附加到正在运行的进程
• 处理异常

✨ 主要特性

核心调试操作

• 会话管理：启动、停止、重启和终止调试会话
• 断点管理：设置行断点和函数断点
• 执行控制：继续、暂停、单步操作（进入/跳出/下一步）
• 状态检查：查看线程、堆栈跟踪、作用域和变量
• 表达式计算：在当前调试上下文中计算表达式
• 变量修改：在调试期间修改变量值

高级特性

• 进程附加：附加到已经在运行的进程
• 模块信息：列出已加载的模块
• 源信息：查看已加载的源文件
• 反汇编：查看反汇编代码
• 异常处理：获取异常信息

📦 安装指南

前提条件

• Go 1.24.4 或更高版本
• 目标语言的支持 DAP 的调试器

从源代码构建

git clone https://github.com/go-delve/mcp-dap-server
cd mcp-dap-server
go build -o bin/mcp-dap-server

💻 使用示例

启动服务器

服务器默认监听 8080 端口：

./bin/mcp-dap-server

通过 MCP 连接

将 MCP 客户端配置为使用 SSE（服务器发送事件）传输协议连接到 http://localhost:8080。

MCP 客户端配置示例

此配置应该适用于（Gemini CLI）[https://developers.google.com/gemini-code-assist/docs/use-agentic-chat-pair-programmer#configure-mcp-servers] 等代理（或作为起点）。

{
  "mcpServers": {
    "dap-debugger": {
      "command": "mcp-dap-server",
      "args": [],
      "env": {}
    }
  }
}

使用 Claude Code 的配置示例

Claude Code

claude mcp add --transport sse mcp-dap-server http://localhost:8080

可用工具

会话管理

• start_debugger：启动新的调试会话。

  • 参数：
    • port（数字）：DAP 服务器的端口号

• stop_debugger：停止当前调试会话。

• restart_debugger：重启当前调试会话。

• terminate_debugger：终止调试器和被调试进程。

程序控制

• debug_program：以调试模式启动程序。

  • 参数：
    • path（字符串）：要调试的程序的路径

• exec_program：不进行调试直接执行程序。

  • 参数：
    • path（字符串）：要执行的程序的路径

• attach_debugger：附加到正在运行的进程。

  • 参数：
    • mode（字符串）：附加模式
    • processId（数字，可选）：要附加的进程 ID

断点

• set_breakpoints：在文件中设置行断点。

  • 参数：
    • file（字符串）：源文件路径
    • lines（数组）：断点的行号

• set_function_breakpoints：设置函数断点。

  • 参数：
    • functions（数组）：函数名

执行控制

• continue：继续程序执行。

  • 参数：
    • threadId（数字，可选）：要继续的线程 ID

• next：单步越过当前行。

  • 参数：
    • threadId（数字）：线程 ID

• step_in：单步进入函数调用。

  • 参数：
    • threadId（数字）：线程 ID

• step_out：单步跳出当前函数。

  • 参数：
    • threadId（数字）：线程 ID

• pause：暂停程序执行。

  • 参数：
    • threadId（数字）：线程 ID

状态检查

• threads：列出被调试进程中的所有线程。

• stack_trace：获取线程的堆栈跟踪。

  • 参数：
    • threadId（数字）：线程 ID
    • startFrame（数字，可选）：起始帧索引
    • levels（数字，可选）：要检索的帧数

• scopes：获取堆栈帧的变量作用域，并自动获取每个作用域内的所有变量。

  • 参数：
    • frameId（数字）：堆栈帧 ID
  • 返回：格式化显示，显示：
    • 所有可用的作用域（局部变量、参数、全局变量等）
    • 每个作用域内的变量及其名称、类型和值
    • 可进一步检查的复合类型的变量引用

• variables：获取作用域内的变量。

  • 参数：
    • variablesReference（数字）：变量引用

• evaluate：计算表达式。

  • 参数：
    • expression（字符串）：要计算的表达式
    • frameId（数字，可选）：帧上下文
    • context（字符串，可选）：计算上下文

• set_variable：设置变量值。

  • 参数：
    • variablesReference（数字）：变量引用
    • name（字符串）：变量名
    • value（字符串）：新值

附加工具

• loaded_sources：列出所有已加载的源文件。

• modules：列出已加载的模块。

• disassemble：反汇编内存位置的代码。

  • 参数：
    • memoryReference（字符串）：内存地址
    • instructionOffset（数字，可选）：指令偏移量
    • instructionCount（数字）：指令数量

• exception_info：获取异常信息。

  • 参数：
    • threadId（数字）：线程 ID

• disconnect：断开与调试器的连接。

  • 参数：
    • terminateDebuggee（布尔值，可选）：是否终止被调试进程

• configuration_done：表示配置已完成。

🤝 贡献

欢迎贡献代码！请随时提交拉取请求。

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

• 使用 Model Context Protocol SDK for Go 构建
• 使用 Google DAP implementation for Go