MCP Server GDB

MCP Server GDB

基于 MCP 协议的 GDB/MI 协议服务，可为 AI 助手提供远程应用调试能力。

功能

• 创建和管理 GDB 调试会话
• 设置和管理断点
• 查看堆栈信息和变量
• 控制程序执行（运行、暂停、单步等）
• 支持并发多会话调试
• 内置 TUI，可检查 Agent 行为以改进提示词（WIP）

安装

预构建二进制文件

在发布页面中找到二进制文件，选择适用于你的工作平台的版本，然后即可直接运行。

从源代码构建

克隆仓库并使用 cargo 构建

cargo build --release
cargo run

使用 Nix

如果已安装 Nix，无需克隆即可运行项目：

本地运行（克隆后）

nix run .

从 GitHub 远程运行

nix run "git+https://github.com/pansila/mcp_server_gdb.git" -- --help

开发环境

要进入包含所有依赖项的开发 Shell：

nix develop

用法

1. 直接运行：./mcp-server-gdb
2. 服务支持两种传输模式：
   • Stdio（默认）：标准输入/输出传输
   • SSE：服务器发送事件传输，默认地址为 http://127.0.0.1:8080

配置

你可以通过修改 src/config.rs 文件或环境变量来调整服务配置：

• 服务 IP 地址
• 服务端口
• GDB 命令超时时间（秒）

支持的 MCP 工具

会话管理

• create_session - 创建新的 GDB 调试会话
• get_session - 获取特定会话信息
• get_all_sessions - 获取所有会话
• close_session - 关闭会话

调试控制

• start_debugging - 开始调试
• stop_debugging - 停止调试
• continue_execution - 继续执行
• step_execution - 单步执行下一行
• next_execution - 单步跳过下一行

断点管理

• get_breakpoints - 获取断点列表
• set_breakpoint - 设置断点
• delete_breakpoint - 删除断点

调试信息

• get_stack_frames - 获取堆栈帧信息
• get_local_variables - 获取局部变量
• get_registers - 获取寄存器
• read_memory - 读取内存内容

许可证

MIT