Dap MCP

🚀 dap - mcp 說明

dap - mcp 是專為管理調試適配器協議 (DAP) 會話而實現的 模型上下文協議 (MCP) 的一個版本。MCP 提供了一個標準化框架，用於優化和擴展大型語言模型的上下文窗口，在此項目中，它被用來增強和簡化調試工作流程。

🚀 快速開始

dap - mcp 是專為管理調試適配器協議 (DAP) 會話而實現的 模型上下文協議 (MCP) 的一個版本，藉助 MCP 標準化框架，能增強和簡化調試工作流程。

✨ 主要特性

• 調試適配器協議集成：使用標準協議與調試工具交互。
• MCP 框架：利用 MCP 優化上下文並提升調試工作流程。
• 豐富的調試工具：可設置、列出和移除斷點；控制執行（繼續、進入/退出/下一步）；評估表達式；切換調用棧；查看源代碼。
• 靈活的配置：通過 JSON 配置文件自定義調試器設置、源目錄和其他參數。

📦 安裝指南

先決條件

• Python 3.10 或更高版本
• uv（可選，用於運行服務器）

安裝和運行服務器

安裝 dap - mcp 及其依賴項：

pip install dap-mcp
python -m dap_mcp --config config.json

# 或者，如果你已經安裝了 uv
uvx dap-mcp@latest --config config.json

📚 詳細文檔

配置

項目使用 JSON 配置文件（例如 .config.json）指定調試器設置和源目錄。配置示例如下：

{
  "type": "debugpy",
  "debuggerPath": "/path/to/python/with/debugpy",
  "debuggerArgs": [
    "-m",
    "debugpy.adapter"
  ],
  // 源代碼目錄，用於解析文件路徑
  // 如果你總是使用絕對路徑，則可以省略此配置
  "sourceDirectories": [
    "src",
    "tests"
  ],
  // 其他調試器特定的設置
  "debuggerSettings": {
    "timeout": 3000,
    ".debugLine": true
  }
}

可用調試器類型

以下調試器類型當前受支持：

工具

以下工具可通過 MCP 框架調用：

• 設置斷點：在指定位置暫停程序執行。
• 列出斷點：顯示所有已設置的斷點信息。
• 移除斷點：刪除指定的斷點。
• 繼續執行：讓程序恢復執行。
• 進入調試：切換到調試模式，逐行執行代碼。
• 退出調試：退出當前調試會話。
• 下一步：執行下一條指令。
• 評估表達式：在當前上下文中計算表達式的值。
• 切換調用棧：在不同的調用堆中進行切換。

擴展

要擴展支持其他 DAP 服務器，請按照以下步驟操作：

基礎用法

創建一個新的調試器類，繼承自 dap_base.DAPProtocol：

class MyDAP(dap_base.DAPProtocol):
    def __init__(self, ...):
        super().__init__(...)

    def on_request(self, request):
        # 處理具體請求邏輯

高級用法

# 更新配置的驗證和解析部分，添加新的調試器類型
debugger_type = Schema(
    {"type": "mydap"},
    Field(..., description="自定義調試器配置")
)

# 在 main 函數中註冊新的調試器實現
def main():
    ...
    if config.type == "mydap":
        dap_protocol = MyDAPProtocol(...)
    ...

貢獻

歡迎貢獻！要參與項目，請按照以下步驟操作：

1. Fork 倉庫。
2. 為你的功能或修復創建一個新的分支。
3. 編寫測試並確保所有檢查通過。
4. 提交一個 Pull Request。

請遵循編碼規範，並在更改中包含適當的測試。

📄 許可證

該項目使用 AGPL - 3.0 許可證。有關詳細信息，請參閱 LICENSE 文件。