dbgmcp

dbgmcp

一组 MCP 服务，用于通过 Model Context Protocol 将各种调试器连接到大模型 Agent。 支持的调试器包括：

• GDB（GNU 调试器）
• LLDB（LLVM 调试器）
• PDB（Python 调试器）

https://github.com/user-attachments/assets/fa745e69-2bd9-482c-b5f1-59b42e458760

功能

• 为每种调试器提供独立的服务。可按需启用或禁用。
• 将程序加载到调试器中。
• 在调试器中执行任意命令。
• 支持多个同时建立的连接。

注意

AI Agent 可以在调试器中执行任意命令，包括 shell 命令。使用风险自负。

安装

最简单的方法是从发布页面为你的平台选择一个预构建二进制文件。 目前，以下平台提供预构建二进制文件：

• Linux x86_64（x86_64-unknown-linux-musl）

二进制文件根据其支持的调试器命名：

• gdb-mcp
• lldb-mcp
• pdb-mcp。

如果你的平台没有可用的预构建二进制文件，可以从源代码构建项目。

从源代码构建

需要安装 Rust 和 Cargo。你可以使用 rustup 安装它们。

git clone https://github.com/ramenhost/dbgmcp
cd dbgmcp

cargo build --release

这将在 target/release/ 文件夹中生成 MCP 服务二进制文件。

用法

Claude Desktop

1. 打开 Claude 桌面应用设置。在设置面板左侧栏中点击“Developer”，然后点击“Edit Config”。这将创建 claude_desktop_config.json 文件并在文件系统中显示该文件。
2. 将所需的 MCP 服务添加到 claude_desktop_config.json。以下配置会在 Claude 中包含所有调试器（GDB、LLDB 和 PDB）。你也可以只添加所需的服务。

{
  "mcpServers": {
    "gdb": {
      "command": "/path/to/gdb-mcp",
      "args": []
    },
    "lldb": {
      "command": "/path/to/lldb-mcp",
      "args": []
    },
    "pdb": {
      "command": "/path/to/pdb-mcp",
      "args": []
    }
  }
}

3. 重启 Claude 或刷新页面。

详情请参阅 Claude 文档。

VS Code Github Copilot

1. 在 VS Code 设置中启用 MCP 支持。要在 VS Code 中启用 MCP 支持，请开启 chat.mcp.enabled 设置。
2. 在工作区中创建 .vscode/mcp.json 文件。
3. 将所需的 MCP 服务添加到 mcp.json 文件。以下配置会在 VS Code 中包含所有调试器（GDB、LLDB 和 PDB）。你也可以只添加所需的服务。

{
    "servers": {
        "gdb": {
            "type": "stdio",
            "command": "/path/to/gdb-mcp",
            "args": []
        },
        "lldb": {
            "type": "stdio",
            "command": "/path/to/lldb-mcp",
            "args": []
        },
        "pdb": {
            "type": "stdio",
            "command": "/path/to/pdb-mcp",
            "args": []
        }
    }
}

4. 重启 VS Code 或重新加载窗口。
5. 现在，调试器工具已可在 Github Copilot 聊天的 Agent 模式中使用。

详情请参阅 VS Code 文档。

致谢

• GDB 功能是对 mcp-gdb 的 Rust 重写