Jdb MCP

🚀 JDB - MCP：Java調試器MCP服務器

JDB - MCP是一個基於Java調試接口（JDI）的模型上下文協議（MCP）服務器。它使AI代理（如Claude、Cline、Trae）能夠對Java應用程序進行深度運行時調試。

🚀 快速開始

安裝與構建

前提條件

• JDK 17+（包含JDI模塊）

構建胖JAR

# 構建所有模塊並在 `release/` 目錄下生成JAR文件
mvn clean package

# 或者為特定的JDK版本進行構建：

# 對於JDK 17+（推薦）
mvn clean package -pl jdb-mcp-jdk17 -am

# 對於JDK 7（舊版本支持）
mvn clean package -pl jdb-mcp-jdk7 -am

可執行的JAR文件將位於 release/ 目錄下：

• release/jdb-mcp.jar（JDK 17+）
• release/jdb-mcp-jdk7.jar（JDK 7）

配置與使用

啟動選項

• --transport <stdio|http>：設置傳輸模式（默認：stdio）。
• --notifications <true|false>：啟用AI即時通知（默認：true）。

如需詳細的工具參數分析，請參考參數指南。

在VSCode（Cline/Claude Dev）中使用

在您的MCP設置中添加以下配置：

{
  "mcpServers": {
    "jdb-debugger": {
      "command": "java",
      "args": [
        "-jar",
        "path/to/jdb-mcp.jar"
      ]
    }
  }
}

調試方法（附加模式）

⚠️ 重要提示

您必須手動啟動啟用了JDWP的目標Java應用程序。

1. 啟動您的項目：

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar your-app.jar

2. 在AI聊天中請求：Attach to localhost:5005 and debug...

✨ 主要特性

• 多傳輸支持：支持 stdio（標準VSCode集成）和 http（用於遠程/curl調試）。
• 全功能調試（僅附加模式）：
  • 附加到正在運行的進程（debug_attach） - 支持任何啟用了JDWP的Java應用程序（SpringBoot、Maven、Gradle等）。
  • 斷點管理（debug_set_breakpoint，debug_set_watchpoint）
  • 流程控制（單步跳過、單步進入、單步跳出、繼續執行）
  • 狀態檢查（堆棧跟蹤檢查、深度結構化變量遍歷）
  • 線程和類檢查（debug_list_threads，debug_list_classes）
  • 動態修改（在運行時更改變量值）
• 簡化設計：目前專注於單會話調試，無需複雜的 sessionId 管理。
• 需要手動調試模式：目標Java應用程序必須手動以啟用JDWP選項啟動。
• 即時感知：利用MCP通知，當斷點命中時，AI代理會立即收到通知。

💻 使用示例

工具列表

• debug_attach：通過套接字附加到現有的調試端口。
• debug_list_threads：列出所有線程及其狀態。
• debug_list_classes：列出已加載的類，支持可選過濾。
• debug_list_methods：列出特定類中的方法。
• debug_source：檢索類的源代碼（需要源根目錄）。
• debug_set_method_breakpoint：在方法入口處設置斷點。
• debug_set_method_entry：監控方法進入事件。
• debug_set_method_exit：監控方法退出事件。
• debug_list_vars：列出變量（支持 threadName、frameIndex 和 scope 過濾）。
• debug_get_var：獲取特定變量的詳細信息。
• debug_set_var：修改運行時變量（支持 threadName 和 frameIndex）。
• ...更多工具請查看 tools/list。

📚 詳細文檔

待辦事項列表

• [ ] 實現 debug_launch：允許用戶通過MCP直接啟動和調試Java程序，實現“開箱即用”的體驗。
• [ ] 實現 debug_calc：支持在調試上下文中計算任意Java表達式（表達式求值）。
• [ ] 多會話支持：重構以允許一個MCP實例同時管理和調試多個目標程序。
• [ ] 包前綴過濾：支持按包前綴（如 com.example.*）過濾方法進入/退出和斷點。
• [ ] 批量類過濾：支持一次傳遞多個類名或通配符模式以過濾事件。
• [ ] 增強斷點控制：支持條件斷點和線程過濾，以實現更精確的調試中斷。
• [ ] 待添加：根據社區反饋添加更多功能。

📄 許可證

本項目根據MIT許可證開源。

🔍 演示