GDB Debugger

🚀 MCP GDB 服務器

MCP GDB 服務器是一個提供 GDB 調試功能的模型上下文協議（MCP）服務器，可與 Claude 或其他 AI 助手協同使用，助力開發者高效完成調試工作。

🚀 快速開始

MCP GDB 服務器為開發者提供了與 AI 助手結合進行 GDB 調試的能力，以下為您介紹使用前的準備和使用方法。

✨ 主要特性

• 啟動和管理 GDB 調試會話，讓調試流程更順暢。
• 加載程序和核心轉儲文件進行分析，深入排查問題根源。
• 設置斷點、逐步執行代碼並查看內存，精準定位問題所在。
• 查看調用堆棧、變量和寄存器，全面掌握程序運行狀態。
• 執行任意 GDB 命令，滿足多樣化的調試需求。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/signal-slot/mcp-gdb.git
cd mcp-gdb

# 安裝依賴項
npm install

# 構建項目
npm run build

💻 使用示例

與 Claude 或其他支持 MCP 的助手一起使用

1. 在 Claude 桌面應用或瀏覽器擴展的 MCP 設置中包含此服務器：

{
  "mcpServers": {
    "gdb": {
      "command": "node",
      "args": ["/path/to/mcp-gdb/build/index.js"],
      "disabled": false
    }
  }
}

2. 重啟 Claude 或刷新頁面。
3. 現在您可以通過與 Claude 的對話使用 GDB 工具。

示例命令

以下是通過 Claude 使用 MCP - GDB 服務器的示例：

基礎用法

啟動 GDB 會話

使用 gdb_start 啟動一個新的調試會話

加載程序

使用 gdb_load 加載 /path/to/my/program 並傳入從 gdb_start 返回的 sessionId

設置斷點

使用 gdb_set_breakpoint 在當前 GDB 會話中設置主程序的斷點

運行程序

使用 gdb_continue 開始執行

查看變量

使用 gdb_print 評估當前上下文中的表達式 "my_variable"

獲取調用堆棧

使用 gdb_backtrace 查看當前的調用堆棧

結束會話

使用 gdb_terminate 結束調試會話

高級用法

本服務器支持多種 GDB 命令，可滿足不同的調試場景。以下為您列舉支持的 GDB 命令及其功能：

• gdb_start：啟動一個新的 GDB 會話。
• gdb_load：加載一個程序到 GDB 中。
• gdb_command：執行任意 GDB 命令。
• gdb_terminate：終止一個 GDB 會話。
• gdb_list_sessions：列出所有活動的 GDB 會話。
• gdb_attach：附加到正在運行的過程。
• gdb_load_core：加載核心轉儲文件。
• gdb_set_breakpoint：設置斷點。
• gdb_continue：繼續程序執行。
• gdb_step：逐步執行程序。
• gdb_next：跳過函數調用。
• gdb_finish：直到當前函數返回為止執行。
• gdb_backtrace：顯示調用堆棧。
• gdb_print：打印表達式值。
• gdb_examine：查看內存。
• gdb_info_registers：顯示寄存器。

📄 許可證

本項目採用 MIT 許可證。