GDB MCP Server

MCP服务器，用于AI Agent调试嵌入式系统程序。支持交叉编译GDB工具（aarch64、arm等），远程调试（gdbserver/QEMU），提供完整的调试信息查询功能。

功能特性

多架构支持: aarch64-none-linux-gnu-gdb, arm-none-eabi-gdb, x86_64-gdb
远程调试: 连接目标板的gdbserver或QEMU模拟器
条件断点: 支持条件表达式断点
完整调试信息: 寄存器、内存、堆栈、变量、线程等
MCP集成: 作为Claude Code或其他MCP客户端的工具使用

快速开始

1. 安装

npm install
npm run build

2. 配置MCP客户端

在Claude Code的设置中添加：

{
  "mcpServers": {
    "gdb": {
      "command": "node",
      "args": ["C:/Users/zjm09/Documents/work/2025/gdb-mcp/dist/index.js"]
    }
  }
}

3. 使用MCP工具

# 初始化GDB
gdb_init({architecture: "aarch64"})

# 连接目标
gdb_connect({target: "localhost:1234"})

# 加载程序
gdb_load_program({programPath: "./main"})

# 设置断点
gdb_set_breakpoint({location: "main.c:10"})
gdb_set_breakpoint({location: "factorial", condition: "n==0"})  # 条件断点

# 执行调试
gdb_run()
gdb_step()
gdb_next()

# 查看信息
gdb_list_registers()
gdb_read_registers({registers: ["pc", "sp"]})
gdb_list_locals()
gdb_evaluate_expression({expression: "x"})

工具列表

连接管理

工具	描述
`gdb_init`	启动GDB进程
`gdb_connect`	连接远程目标
`gdb_disconnect`	断开并终止GDB
`gdb_load_program`	加载可执行文件

执行控制

工具	描述
`gdb_run`	开始执行
`gdb_continue`	继续执行
`gdb_step`	单步进入函数
`gdb_next`	单步跳过函数
`gdb_finish`	执行到返回
`gdb_interrupt`	中断执行

断点管理

工具	描述
`gdb_set_breakpoint`	设置断点（支持条件）
`gdb_delete_breakpoint`	删除断点
`gdb_list_breakpoints`	列出断点
`gdb_enable_breakpoint`	启用断点
`gdb_disable_breakpoint`	禁用断点
`gdb_set_condition`	设置断点条件

内存/寄存器

工具	描述
`gdb_read_memory`	读取内存
`gdb_list_registers`	列出寄存器名
`gdb_read_registers`	读取寄存器值
`gdb_write_register`	写入寄存器

堆栈/变量

工具	描述
`gdb_list_frames`	列出调用栈
`gdb_select_frame`	选择栈帧
`gdb_list_locals`	列出局部变量
`gdb_list_arguments`	列出函数参数
`gdb_evaluate_expression`	计算表达式

线程管理

工具	描述
`gdb_list_threads`	列出线程
`gdb_select_thread`	选择线程

调试信息

工具	描述
`gdb_get_current_location`	获取当前位置
`gdb_list_source_files`	列出源文件
`gdb_disassemble`	反汇编

高级

工具	描述
`gdb_command`	执行原始GDB MI命令

测试

使用QEMU模拟

cd tests/test-program
make                # 交叉编译
bash start-qemu.sh  # 启动QEMU等待GDB连接

测试流程

启动QEMU后，使用MCP工具连接
设置断点、执行调试
查看变量、寄存器等调试信息

项目结构

gdb-mcp/
├── src/
│   ├── index.ts           # MCP服务器入口
│   ├── gdb/
│   │   ├── gdb-process.ts # GDB进程管理
│   │   ├── mi-parser.ts   # MI输出解析
│   │   ├── mi-commands.ts # MI命令构建
│   │   └── types.ts       # 类型定义
│   ├── schemas/           # Zod验证
│   └── constants.ts       # 配置常量
├── tests/
│   └ test-program/        # 测试程序
│   └ README.md
│   └ tsconfig.json
│   └ package.json

开发

npm run dev      # 开发模式（自动重载）
npm run build    # 编译
npm run inspector # 使用MCP Inspector测试

许可证

MIT