Go Debugger (Delve)

🚀 MCP Go Debugger

An interface for debugging Go programs integrated with the Model Context Protocol (MCP).

🚀 Quick Start

The MCP Go Debugger is an interface for debugging Go programs integrated with the Model Context Protocol (MCP). It offers a range of features to facilitate the debugging process.

✨ Features

• Launch and debug Go applications.
• Attach to existing Go processes.
• Set breakpoints.
• Step through code (step into, step over, step out).
• Evaluate variables.
• View stack traces.
• List all variables in the current scope.
• Get the current execution position.
• Debug individual test functions using debug_test.
• Native integration with the Delve debugger API types.
• Capture and display the program's output during debugging.
• Support custom test flags when debugging tests.
• Detailed variable inspection with configurable depth.

📦 Installation

Prerequisites

• Go 1.20 or higher.

Install with Go

The simplest way to install the MCP Go Debugger is by using Go:

go install github.com/sunfmin/mcp-go-debugger/cmd/mcp-go-debugger@latest

This will download, compile, and install the binary to your $GOPATH/bin directory.

Build from Source

Alternatively, you can build from source:

git clone https://github.com/sunfmin/mcp-go-debugger.git
cd mcp-go-debugger
make install

📚 Documentation

Configuration

Cursor

Add the following to your Cursor configuration file (~/.cursor/mcp.json):

{
  "mcpServers": {
    "go-debugger": {
      "command": "mcp-go-debugger",
      "args": []
    }
  }
}

Claude Desktop

Add MCP to Claude Desktop:

claude mcp add go-debugger mcp-go-debugger

Verify the connection:

claude mcp ls

Usage Instructions

Start the Debugger

Start the debugger from the command line:

mcp-go-debugger start

Connect to the Debugger

Connect to a running debugger instance using the following command:

mcp-go-debugger connect --addr <debugger_addr>

Tools

Here is a list of available tools and their descriptions:

Examples

Start the debugger from the command line:

mcp-go-debugger start --port 9999

Connect to a debugger instance:

mcp-go-debugger connect --addr localhost:9999

📄 License

MIT License