{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rm45tm4acgsw","handle":"iflow-mcp-yywz1999-gdb-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-yywz1999-gdb-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-yywz1999-gdb-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-yywz1999-gdb-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-yywz1999-gdb-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-yywz1999-gdb-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-yywz1999-gdb-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-yywz1999-gdb-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-yywz1999-gdb-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-yywz1999-gdb-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-yywz1999-gdb-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-yywz1999-gdb-mcp-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-yywz1999-gdb-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_yywz1999-gdb-mcp-server","summary":"GDB Model Context Protocol Server for AI-assisted debugging","description":"# GDB MCP 服务器\n\n一个支持人工智能辅助调试的 GDB MCP (Model Context Protocol) 服务器。该服务器允许 AI 代理和其他工具通过 MCP 协议与 GDB 进行交互。\n\n> **注意**：本项目目前处于开发阶段。我们欢迎社区成员提出建议和反馈，帮助我们改进这个工具。\n\n项目地址：https://github.com/yywz1999/gdb-mcp-server\n\n## 特性\n\n- 发现并附加到现有的 GDB 进程\n- 通过终端窗口与 GDB 通信（macOS 上优化支持 iTerm2，Linux 使用 tmux）\n- 支持 MCP 协议，便于与 AI 助手集成\n- 智能处理 GDB 命令阻塞，自动发送中断信号\n- 支持多架构、多主机和远程调试场景\n- 通过简单的函数调用执行常见的 GDB 调试操作：\n  - 设置和删除断点\n  - 单步执行代码\n  - 检查内存\n  - 查看寄存器和堆栈跟踪\n  - 反汇编代码\n  - 获取局部变量\n\n## 演示视频\n\n项目包含一个演示视频，展示了如何使用 GDB MCP 服务器进行附加调试的完整工作流程：\n\nhttps://github.com/user-attachments/assets/dbb5c2dc-1bc9-4a19-86d7-c967725bc145\n\n通过观看此视频，您可以更直观地了解 GDB MCP 服务器如何简化多架构和远程调试场景。\n\n## 使用说明（以Cursor为例）\n\n1. 下载项目并验证：\n``` shell\ngit clone https://github.com/yywz1999/gdb-mcp-server.git\ncd gdb-mcp-server\npython3 -m pip install -r requirements.txt\npython3 ~/MCP_server/gdb-mcp-server/mcp_server.py\n```\n结果如下图所示，即为环境正常\n<img width=\"1440\" alt=\"image\" src=\"https://github.com/user-attachments/assets/03437c53-2f93-414c-b5bf-0405b5bbe8f9\" />\n\n2. 配置Cursor：\n<img width=\"553\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e697d13f-27bf-410d-9cfe-05256e513dd2\" />\n\n## 2025/11/27 更新内容：\n- 1、Linux 端 tmux 适配全面升级：自动遍历所有 session/pane、过滤 `gdbserver`，精准附加到 pwndbg/gef 等交互式 gdb 会话，无需切换窗口。\n- 2、iTerm2 会话识别更精准：直接写入目标窗口且可按内容定位 GDB 会话，无需手动切换焦点。\n- 3、阻塞处理更智能：自动判定 `continue/target remote` 等高风险命令并在阻塞时发送中断信号，配合唯一标记让输出更干净。\n\n## 与 gdb-mcp-server-main 相比的新增能力\n\n- **终端输出隔离**：tmux 侧统一插入唯一的开始/结束标记，自动清理命令和提示符，AI 仅接收结构化结果，不再混入终端错误。\n- **阻塞检测与自动中断**：针对 `continue`、`run`、`target remote` 等命令，提供多次轮询与 `Ctrl-C` 自动中断策略，并返回清晰提示。\n- **Linux 端适配**：新的 tmux 通信链可以遍历所有 session/pane，精确定位真正的 `gdb/pwndbg/gef` 进程并忽略 `gdbserver`，整个控制过程无需切换窗口。\n- **更安全的进程筛选**：`sys_find_gdb_processes` 与 tmux 探测逻辑会过滤 Python 启动脚本及远程 server，只附加到可交互的本地 GDB。\n- **API 精简**：移除了不再需要的“启动 GDB”接口，保留并强化“查找 → 附加 → 执行”主流程，让 README、工具列表与实现保持一致。\n\n## 技术实现简介\n\nGDB MCP 服务器使用以下技术实现 GDB 的控制和通信：\n\n1. **MCP 协议实现**：使用 [FastMCP](https://github.com/jlowin/fastmcp) 库提供符合 Model Context Protocol 规范的工具接口\n\n2. **多种通信策略**：\n   - **AppleScript**：在…","publisher":null,"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_yywz1999-gdb-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_yywz1999-gdb-mcp-server","registry":"pypi","observedAt":"2026-09-15T20:21:41.999Z","publishedAt":"2026-02-08T04:22:05.220846Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_yywz1999-gdb-mcp-server","url":"https://pypi.org/project/iflow-mcp_yywz1999-gdb-mcp-server/","firstSeenAt":"2026-09-09T21:25:19.191Z","fetchedAt":"2026-09-15T20:21:02.676Z","normalizedAt":"2026-09-15T20:21:02.676Z"}]},"firstSeenAt":"2026-09-09T21:25:19.191Z","updatedAt":"2026-09-15T20:21:41.999Z"}