返回 MCP 目录
public公开dns本地运行

mcp_server_gdb

一个基于MCP协议的GDB/MI服务器,提供远程应用调试功能并支持AI助手

article

README

🚀 MCP 服务器 GDB

MCP 服务器 GDB 是一个基于 MCP 协议的 GDB/MI 协议服务器,可提供远程应用程序调试功能,还具备 AI 助手支持,助力开发者高效完成调试工作。

🚀 快速开始

MCP 服务器 GDB 使用便捷,您可根据自身需求选择不同的启动方式。直接运行 ./mcp-server-gdb 即可开启服务,服务器支持标准输入/输出(默认)和 Server-Sent Events(默认地址为 http://127.0.0.1:8080)两种传输模式。

✨ 主要特性

  • 会话管理:能够创建并管理 GDB 调试会话,支持并发多会话调试,提升调试效率。
  • 断点控制:可灵活设置和管理断点,精准定位问题代码。
  • 信息查看:方便查看堆栈信息和变量,助您深入了解程序运行状态。
  • 程序执行:可控制程序执行,包括运行、暂停、单步等操作。
  • TUI 检查:内置 TUI 检查代理行为,目前正在开发优化提示词功能(WIP)。

📦 安装指南

预编译二进制文件

您可在发布页面找到适用于自己操作系统的二进制文件,下载后直接运行即可。

从源代码构建

若您想从源代码构建,可按以下步骤操作:

cargo build --release
cargo run

📚 详细文档

配置说明

您可通过修改 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 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端