MCP 服务器

GDB MCP Server

用于 GDB 调试的 MCP 服务器。

smadi0x86

开发者工具

访问服务器

README

GDB MCP 服务器

https://github.com/user-attachments/assets/1bac46ee-4054-432d-95b8-660c9062d863

一个使用 MCP Python SDK 编写的 MCP 服务器，使 LLM 能够与 GDB 交互，进行程序调试和分析。该工具允许 LLM 通过生成式 AI 界面执行复杂的调试任务。

功能

会话管理
- 启动和管理多个 GDB 会话
- 加载程序和核心转储
- 附加到正在运行的进程
调试命令
- 设置带有条件的断点
- 单步执行代码（step, next, finish）
- 继续执行
- 获取回溯
- 打印变量值
- 反汇编代码
- 列出可用函数
- 检查寄存器
高级功能
- 多会话支持
- 工作目录配置
- 程序参数处理
- 核心转储分析
- 符号检查

注意: 由于 GDB Machine Interface (MI) 输出解析问题，info functions 和 disassemble 命令暂时禁用。这些功能将在未来的更新中恢复，一旦输出解析得到正确实现。

项目状态

有关已知问题和当前错误，请参阅 BUGS.md
有关计划的改进和功能，请参阅 TODO.md

可用工具

GDB_COMMANDS = [
    gdb_start,
    gdb_load,
    gdb_run,
    gdb_command,
    gdb_attach,
    gdb_load_core,
    gdb_set_breakpoint,
    gdb_continue,
    gdb_step,
    gdb_next,
    gdb_finish,
    gdb_backtrace,
    gdb_print,
    gdb_disassemble,
    gdb_info_registers,
    gdb_info_functions,
    gdb_list_sessions,
    gdb_terminate,
]

安装

克隆存储库：

git clone https://github.com/smadi0x86/gdb-mcp.git
cd gdb-mcp

使用 Poetry 安装依赖项：

poetry install

以开发模式安装软件包：

poetry install

用法

启动 GDB MCP 服务器：

python3 gdb-mcp.py

服务器将在 stdio 上运行，准备好接受命令。

LLM 客户端配置

对于 Claude Desktop

将此配置添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
     "gdb": {
    "command": "python3",
    "args": ["/home/your-username/dev/personal/gdb-mcp/gdb-mcp.py"]
    }
  }
}

对于 VS Code Copilot

将此配置添加到您的 VS Code 设置：

{
  "mcp": {
    "inputs": [],
    "servers": {
      "gdb": {
        "command": "python3",
        "args": ["/home/your-username/dev/personal/gdb-mcp/gdb-mcp.py"]
      }
    }
  }
}

使用示例程序进行测试

使用调试符号编译示例程序：

gcc -g example.c -o example

将此提示与您的 LLM 客户端一起使用：

我有一个二进制文件位于 /path/to/example，我需要分析它。 我无法访问源代码。 请帮助我使用 GDB 理解和调试此程序。

1. 启动一个 GDB 会话并加载二进制文件
2. 使用 info functions 发现有哪些可用的函数
3. 对于每个有趣的函数：
   - 反汇编它以了解其行为
   - 在关键指令处设置断点
   - 运行程序并检查断点处的变量
4. 当程序崩溃或出现意外行为时：
   - 获取回溯
   - 检查寄存器和变量
   - 帮助我理解可能导致问题的原因

对于每个步骤：
- 解释我们正在做什么以及为什么
- 向我展示反汇编或变量值
- 帮助我解释我们所看到的内容
- 根据我们的发现建议下一步