Gdb Mcp Server

by yywz1999

84 stars

412 downloads

Not rated

GitHub

Description

About

Details

Author: yywz1999
GitHub stars: 84
Downloads: 412
Categories: Other, Developer Tools

- Discovers and attaches to existing GDB processes automatically
- Communicates with GDB via iTerm2 (macOS) or tmux (Linux)
- Provides a full set of debugging tools: breakpoints, stepping, memory inspection, registers, stack trace, disassembly, local variables
- Supports multi‑architecture, multi‑host, and remote debugging
- Intelligent blocking command detection with auto‑send of interrupt signal

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Gdb Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

From the repository

Clone the repository, install dependencies with python3 -m pip install -r requirements.txt, then start the server with python3 mcp_server.py. Configure an MCP client (e.g., Cursor) to connect to the server and use the provided tool functions to interact with GDB.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gdb mcp server": {
            "gdb-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "pip",
                    "install",
                    "-r",
                    "requirements.txt"
                ]
            }
        }
    }
}

McpServers

{
    "gdb-mcp-server": {
        "command": "python3",
        "args": [
            "-m",
            "pip",
            "install",
            "-r",
            "requirements.txt"
        ]
    }
}

# 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**：在 macOS 上与 iTerm2 通信（推荐） - **pexpect**：直接与 GDB 进程通信（Linux 优先） - **键盘模拟**：作为最后的回退方案 3. **进程发现**：自动查找系统中运行的 GDB 进程，无需用户手动指定进程 ID ## 测试环境 - 操作系统：macOS（Intel架构） - Python版本：Python 3.11 - 终端：iTerm2 ## 安装 1. 克隆仓库： ```bash git clone https://github.com/yywz1999/gdb-mcp-server.git cd gdb-mcp-server ``` 2. 安装依赖： ```bash python3 -m pip install -r requirements.txt ``` ## 使用方法 1. 启动服务器： ```bash python3 mcp_server.py ``` 2. 使用 MCP 协议通过服务器与 GDB 交互。服务器提供以下工具函数： ### 系统工具 - `sys_find_gdb_processes` - 查找所有运行的 GDB 进程 - `sys_attach_to_gdb` - 附加到 GDB 进程 ### GDB 调试工具 - `gdb_execute_command` - 执行任意 GDB 命令 - `gdb_set_breakpoint` - 设置断点 - `gdb_delete_breakpoint` - 删除断点 - `gdb_step` - 单步执行 - `gdb_next` - 执行到下一行 - `gdb_finish` - 执行到函数返回 - `gdb_continue` - 继续执行 - `gdb_get_registers` - 获取寄存器值 - `gdb_examine_memory` - 检查内存 - `gdb_get_stack` - 获取堆栈跟踪 - `gdb_get_locals` - 获取局部变量 - `gdb_disassemble` - 反汇编代码 - `gdb_connect_remote` - 连接到远程调试目标 ## macOS 上的最佳实践在 macOS 上使用 GDB MCP 服务器时，建议： 1. 使用 iTerm2 作为终端模拟器（提供最佳支持） 2. 确保 GDB 终端窗口在启动服务器前已打开 3. 对于远程调试，建议先手动在 GDB 中设置相关配置，然后通过 MCP 服务器附加 ## 故障排除 ### macOS 上的常见问题 1. **窗口激活问题**：如果 GDB 窗口无法正确激活，尝试手动将其置于前台 2. **输入法状态**：确保 GDB 终端未处于中文或其他输入法状态 3. **命令阻塞**：对于阻塞的命令（如 target remote），服务器会自动发送中断信号 ### Linux 上的常见问题 1. **TTY 权限**：确保当前用户有权限访问 GDB 进程的 TTY 设备 2. **pexpect 依赖**：确保已安装 pexpect 库 ## 许可证本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Gdb Mcp Server

Description

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Install

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive