yywz1999/gdb-mcp-server
If you are the rightful owner of gdb-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
GDB MCP 服务器是一个支持人工智能辅助调试的服务器，允许 AI 代理和其他工具通过 MCP 协议与 GDB 进行交互。
GDB MCP 服务器
一个支持人工智能辅助调试的 GDB MCP (Model Context Protocol) 服务器。该服务器允许 AI 代理和其他工具通过 MCP 协议与 GDB 进行交互。
注意：本项目目前处于开发阶段。我们欢迎社区成员提出建议和反馈，帮助我们改进这个工具。
项目地址：https://github.com/yywz1999/gdb-mcp-server
特性
- 发现并附加到现有的 GDB 进程
- 通过终端窗口与 GDB 通信（macOS 上优化支持 iTerm2，Linux 使用 tmux）
- 支持 MCP 协议，便于与 AI 助手集成
- 智能处理 GDB 命令阻塞，自动发送中断信号
- 支持多架构、多主机和远程调试场景
- 通过简单的函数调用执行常见的 GDB 调试操作：
- 设置和删除断点
- 单步执行代码
- 检查内存
- 查看寄存器和堆栈跟踪
- 反汇编代码
- 获取局部变量
演示视频
项目包含一个演示视频，展示了如何使用 GDB MCP 服务器进行附加调试的完整工作流程：
https://github.com/user-attachments/assets/dbb5c2dc-1bc9-4a19-86d7-c967725bc145
通过观看此视频，您可以更直观地了解 GDB MCP 服务器如何简化多架构和远程调试场景。
使用说明（以Cursor为例）
- 下载项目并验证：
git clone https://github.com/yywz1999/gdb-mcp-server.git
cd gdb-mcp-server
python3 -m pip install -r requirements.txt
python3 ~/MCP_server/gdb-mcp-server/mcp_server.py
结果如下图所示，即为环境正常
- 配置Cursor：
2025/11/27 更新内容：
- 1、Linux 端 tmux 适配全面升级：自动遍历所有 session/pane、过滤
gdbserver，精准附加到 pwndbg/gef 等交互式 gdb 会话，无需切换窗口。 - 2、iTerm2 会话识别更精准：直接写入目标窗口且可按内容定位 GDB 会话，无需手动切换焦点。
- 3、阻塞处理更智能：自动判定
continue/target remote等高风险命令并在阻塞时发送中断信号，配合唯一标记让输出更干净。
与 gdb-mcp-server-main 相比的新增能力
- 终端输出隔离：tmux 侧统一插入唯一的开始/结束标记，自动清理命令和提示符，AI 仅接收结构化结果，不再混入终端错误。
- 阻塞检测与自动中断：针对
continue、run、target remote等命令，提供多次轮询与Ctrl-C自动中断策略，并返回清晰提示。 - Linux 端适配：新的 tmux 通信链可以遍历所有 session/pane，精确定位真正的
gdb/pwndbg/gef进程并忽略gdbserver，整个控制过程无需切换窗口。 - 更安全的进程筛选：
sys_find_gdb_processes与 tmux 探测逻辑会过滤 Python 启动脚本及远程 server，只附加到可交互的本地 GDB。 - API 精简：移除了不再需要的“启动 GDB”接口，保留并强化“查找 → 附加 → 执行”主流程，让 README、工具列表与实现保持一致。
技术实现简介
GDB MCP 服务器使用以下技术实现 GDB 的控制和通信：
-
MCP 协议实现：使用 FastMCP 库提供符合 Model Context Protocol 规范的工具接口
-
多种通信策略：
- AppleScript：在 macOS 上与 iTerm2 通信（推荐）
- pexpect：直接与 GDB 进程通信（Linux 优先）
- 键盘模拟：作为最后的回退方案
-
进程发现：自动查找系统中运行的 GDB 进程，无需用户手动指定进程 ID
测试环境
- 操作系统：macOS（Intel架构）
- Python版本：Python 3.11
- 终端：iTerm2
安装
-
克隆仓库：
git clone https://github.com/yywz1999/gdb-mcp-server.git cd gdb-mcp-server -
安装依赖：
python3 -m pip install -r requirements.txt
使用方法
-
启动服务器：
python3 mcp_server.py -
使用 MCP 协议通过服务器与 GDB 交互。服务器提供以下工具函数：
系统工具
sys_find_gdb_processes- 查找所有运行的 GDB 进程sys_attach_to_gdb- 附加到 GDB 进程
GDB 调试工具
gdb_execute_command- 执行任意 GDB 命令gdb_set_breakpoint- 设置断点gdb_delete_breakpoint- 删除断点gdb_step- 单步执行gdb_next- 执行到下一行gdb_finish- 执行到函数返回gdb_continue- 继续执行gdb_get_registers- 获取寄存器值gdb_examine_memory- 检查内存gdb_get_stack- 获取堆栈跟踪gdb_get_locals- 获取局部变量gdb_disassemble- 反汇编代码gdb_connect_remote- 连接到远程调试目标
macOS 上的最佳实践
在 macOS 上使用 GDB MCP 服务器时，建议：
- 使用 iTerm2 作为终端模拟器（提供最佳支持）
- 确保 GDB 终端窗口在启动服务器前已打开
- 对于远程调试，建议先手动在 GDB 中设置相关配置，然后通过 MCP 服务器附加
故障排除
macOS 上的常见问题
- 窗口激活问题：如果 GDB 窗口无法正确激活，尝试手动将其置于前台
- 输入法状态：确保 GDB 终端未处于中文或其他输入法状态
- 命令阻塞：对于阻塞的命令（如 target remote），服务器会自动发送中断信号
Linux 上的常见问题
- TTY 权限：确保当前用户有权限访问 GDB 进程的 TTY 设备
- pexpect 依赖：确保已安装 pexpect 库
许可证
本项目采用 MIT 许可证 - 详见 文件
