Gdb MCP

🚀 GDB MCP Server (FastMCP)

A lightweight MCP server that operates within GDB. It offers a single tool, gdb-command, which directly forwards input to GDB's command interpreter and returns the textual output.

🚀 Quick Start

1. Initiate GDB with the MCP extension loaded

• gdb -q -ex 'source ./gdb-mcp'
• Alternatively, load it within GDB using source ./gdb-mcp

2. Start the SSE server within GDB

• mcp-server 127.0.0.1 3333

3. Connect an MCP client to the server

• Configure your MCP client to connect to the SSE server at the host/port selected above and invoke the gdb-command tool.

✨ Features

• gdb-command: Send any GDB command and receive its output.
• Minimal, self - contained script: gdb-mcp (loaded via source).

📦 Installation

Requirements

• GDB with Python support enabled.
• Python 3.x and the fastmcp library accessible to GDB’s embedded Python.

Check Python support

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

Install FastMCP

python3 -m pip install fastmcp

If the import fails in GDB, make sure fastmcp is installed in the same Python environment that GDB uses.

💻 Usage Examples

Tool: gdb-command

• Parameters:
  • command (string): The precise GDB command to execute (e.g., info registers).
• Returns: A string (either the captured GDB output or an error message).

📚 Documentation

Notes & Tips

⚠️ Important Note

This script does not provide timeout or stop control. To interrupt long - running target execution, issue the interrupt command.

⚠️ Important Note

Do not expose this server publicly unless you trust the clients, as this endpoint can execute arbitrary GDB commands.

💡 Usage Tip

To enable auto - loading, add the following line to your ~/.gdbinit: source /absolute/path/to/gdb-mcp.

💡 Usage Tip

There is no built - in 'stop server' functionality. To shut down the server, exit GDB.

📄 License

This project is licensed under the MIT license — see LICENSE for details.

👏 Acknowledgements

This project is built on top of the excellent fastmcp library.