Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client