iflow-mcp_yywz1999-gdb-mcp-server

# 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为例） 1. 下载项目并验证： ``` shell 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 ``` 结果如下图所示，即为环境正常 <img width="1440" alt="image" src="https://github.com/user-attachments/assets/03437c53-2f93-414c-b5bf-0405b5bbe8f9" /> 2. 配置Cursor： <img width="553" alt="image" src="https://github.com/user-attachments/assets/e697d13f-27bf-410d-9cfe-05256e513dd2" /> ## 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 的控制和通信： 1. **MCP 协议实现**：使用 [FastMCP](https://github.com/jlowin/fastmcp) 库提供符合 Model Context Protocol 规范的工具接口 2. **多种通信策略**： - **AppleScript**：在…