GEF MCP Server v2.0

玄幕安全团队 - guaidao2 开发 🛡️

GDB Enhanced Features 的 Model Context Protocol (MCP) 服务器实现，支持通过 SSE 或 stdio 进行远程调试。专为安全测试和 CTF 竞赛优化。

特性

• GEF/GDB 集成: 自动加载 GEF 插件，提供增强调试能力
• 多会话: 最多 4 个并发调试会话
• SSE + stdio 双模式: 远程 HTTP SSE 或本地 Claude Desktop stdio
• PTY 终端: 真实终端模拟，支持交互式调试
• 41 个专用工具: 覆盖调试、内存操作、二进制分析、CTF exploit 开发全流程
• CTF 定向增强: checksec、ROP 搜索、format-string 检测、patch、assemble 等
• 安全防护: 路径注入消杀、换行防护、输出大小限制
• 后台僵尸回收: 自动清理崩溃的会话

安装

cd /root/Desktop/gef-mcp
pip install -r requirements.txt

安装 GEF（如未安装）

bash -c "$(curl -fsSL https://gef.blah.cat/sh)"

使用

# SSE 模式 (默认 :8000)
python server.py

# 指定地址和端口
python server.py --host 127.0.0.1 --port 8080

# stdio 模式 (Claude Desktop)
python server.py --transport stdio

MCP 端点

• SSE 端点: http://localhost:8000/sse
• 消息端点: http://localhost:8000/messages/

工具列表

会话管理

工具	描述
create_session	创建新调试会话
list_sessions	列出所有活跃会话
close_session	关闭会话

文件与启动

工具	描述
load_file	加载目标二进制
start_debugging	加载文件 + 显示 GEF 上下文

断点

工具	描述
set_breakpoint	设置断点 (函数/地址/文件:行)
delete_breakpoint	按编号删除断点
list_breakpoints	列出所有断点/监视点
watchpoint	设置数据断点 (读/写/访问)

执行控制

工具	描述
run	运行程序 (带参数)
continue	继续执行
step	单步进入
next	单步跳过

寄存器 / 栈

工具	描述
get_registers	获取 CPU 寄存器
get_backtrace	函数调用回溯
info_frame	当前栈帧详细信息

反汇编

工具	描述
disassemble	反汇编代码

内存操作

工具	描述
examine_memory	检查内存 (x/16xg)
write_memory	向内存写入值
patch_byte	GEF patch 修改字节
hexdump	十六进制 + ASCII 视图
telescope	递归解引用 (望远镜)
search_pattern	搜索内存模式
search_strings	搜索可打印字符串

GEF 增强

工具	描述
vmmap	虚拟内存映射
heap	堆信息
checksec	🔐 安全缓解措施检查
got_plt	GOT/PLT 信息
get_context	完整调试上下文
get_sections	节区信息
get_entry_point	入口点地址
elf_info	ELF 文件头信息
reset_cache	重置 GEF 缓存

CTF 专用 🔥

工具	描述
rop_search	搜索 ROP gadgets
rop_search_all	列出所有 gadgets
attach_process	附加到进程
detach_process	从进程分离
format_string_helper	检测格式化字符串漏洞
assemble	写入汇编指令
nop_sled	写入 NOP chain
execute_command	任意 GEF/GDB 命令

与 Claude Desktop 集成

{
  "mcpServers": {
    "gef": {
      "command": "python",
      "args": ["/root/Desktop/gef-mcp/server.py", "--transport", "stdio"]
    }
  }
}

安全说明

• filepath 参数经过注入消杀，拒绝含有 ! ; | 等 shell 元字符的路径
• pattern 参数拒绝换行符，防止命令注入
• execute_command 按设计执行任意命令——请确保调用来源可信
• 所有会话输出有 50KB 大小限制，防止内存膨胀

调试流程示例 (CTF)

# 1. 创建会话
session = await call_tool("create_session", {})
sid = session["session_id"]

# 2. 加载目标
await call_tool("load_file", {"session_id": sid, "filepath": "./vuln"})

# 3. 安全检查
sec = await call_tool("checksec", {"session_id": sid})
# → NX: enabled | PIE: disabled | Canary: enabled ...

# 4. 查看内存布局
map = await call_tool("vmmap", {"session_id": sid})

# 5. 断点 + 运行
await call_tool("set_breakpoint", {"session_id": sid, "location": "main"})
await call_tool("run", {"session_id": sid})

# 6. 搜索 ROP gadgets
gadgets = await call_tool("rop_search", {"session_id": sid, "gadget": "pop rdi"})

# 7. 检查 GOT
got = await call_tool("got_plt", {"session_id": sid})

# 8. 修改内存
await call_tool("write_memory", {
    "session_id": sid,
    "address": "0x601040",
    "value": "0xdeadbeef"
})

许可证

MIT