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