Gdb MCP

🚀 GDB MCP Server (FastMCP)

GDB MCP Server (FastMCP) 是一款輕量級的 MCP 服務器，可在 GDB 內部運行。它僅提供一個工具 gdb-command，該工具可將輸入直接轉發給 GDB 的命令解釋器，並返回文本輸出。此服務器通過 SSE 運行，可在 GDB 內部使用 mcp-server 命令啟動。

✨ 主要特性

• gdb-command：可傳遞任意 GDB 命令並返回其輸出。
• 最小化、自包含的腳本 gdb-mcp（通過 source 加載）。

📦 安裝指南

環境要求

• 啟用 Python 支持的 GDB。
• Python 3.x 以及 GDB 嵌入式 Python 可用的 fastmcp 庫。

檢查 Python 支持

使用以下命令檢查 GDB 是否支持 Python：

gdb -q -ex "python print('ok')" -ex quit

安裝 FastMCP

使用以下命令安裝 fastmcp 庫：

python3 -m pip install fastmcp

若在 GDB 中導入失敗，請確保 fastmcp 安裝到 GDB 使用的同一 Python 環境中。

🚀 快速開始

1. 啟動加載了 MCP 擴展的 GDB

可以使用以下命令啟動 GDB 並加載 MCP 擴展：

gdb -q -ex 'source ./gdb-mcp'

或者在 GDB 內部加載：

source ./gdb-mcp

2. 在 GDB 內部啟動 SSE 服務器

使用以下命令啟動 SSE 服務器：

mcp-server 127.0.0.1 3333

3. 將 MCP 客戶端連接到服務器

將 MCP 客戶端配置為連接到上述所選主機/端口的 SSE 服務器，並調用 gdb-command 工具。

工具：gdb-command

參數

• command（字符串）：要運行的精確 GDB 命令（例如 info registers）。

返回值

字符串（捕獲的 GDB 輸出或錯誤消息）。

📚 詳細文檔

注意事項和提示

⚠️ 重要提示

• 此腳本未提供超時或停止控制。若要中斷長時間運行的目標執行，請發出 interrupt 命令。
• 除非信任客戶端，否則請勿公開綁定此端點，因為它可以執行任意 GDB 命令。
• 若要自動加載，可在 ~/.gdbinit 中添加一行：source /absolute/path/to/gdb-mcp。
• 此工具沒有內置的“停止服務器”功能。若要關閉服務器，請退出 GDB。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

致謝

本項目基於出色的 fastmcp 庫構建。