Dlv MCP

A Go language debugging service based on the MCP protocol that allows AI assistants to interactively debug Go programs through the Delve debugger.

Developer tools Education and learning tools #Go debugging #AI tools #MCP service #Interactive debugging .Go

rating : 2.5 points

downloads : 5.4K

update time : 2025-04-28

Open Site

What is the Go Delve Debugger MCP Server?

This is a server that implements the Model Context Protocol (MCP). It serves as a bridge, allowing AI assistants to interact with the Go language Delve debugger. Through this server, AI can start, control, and monitor debugging sessions of Go programs.

How to use this service?

You need to install the server first, and then connect to the server endpoint through an MCP client (such as Cursor). After that, the AI assistant can help you debug Go programs by sending debugging commands.

Applicable scenarios

It is particularly useful when you need an AI assistant to help debug Go programs, such as automatically locating problems, setting breakpoints, and checking variable values. It is also suitable for teaching scenarios, allowing AI to guide the learning of Go language debugging.

Main features

Debug session management

Can start, terminate, and list debugging sessions of multiple Go programs

Breakpoint management

Can set breakpoints at specific lines in a specified file

Execution control

Supports debugging operations such as step over/into/out and continue execution

Program inspection

Can evaluate expressions, check variable values, and view the call stack

Advantages

Enables AI assistants to directly interact with the Go debugger

Supports multiple debugging operations with comprehensive functions

Can manage multiple debugging sessions simultaneously

Based on the standard MCP protocol, compatible with multiple clients

Limitations

Only supports debugging Go language programs

Requires the pre - installation of the Delve debugger

Currently only supports the command - line interface

How to use

Installation preparation

Ensure that Go 1.21+ and the Delve debugger are installed

Install the MCP server

Use the go install command to install dlv - mcp

Start the server

Run the server and specify the listening port

Connect the client

Configure the server address in the MCP client (such as Cursor)

Usage examples

Basic debugging process

Demonstrate how to start a debugging session and set a breakpoint

Variable inspection

Check the variable value at a breakpoint

Frequently Asked Questions

How to view all debugging sessions?

What are the differences between debugging modes?

Why isn't my breakpoint triggered?

Related resources

Model Context Protocol specification

Official documentation of the MCP protocol

Delve debugger

Homepage of the Go language debugger project

Example code

Project usage examples

🚀 Go Delve Debugger MCP Server

This project is an MCP server that enables Large Language Models (LLMs) to interact with the Delve Go debugger, facilitating AI-assisted debugging of Go applications.

🚀 Quick Start

The project implements a Model Context Protocol (MCP) server integrated with the Delve Go debugger. This integration allows AI assistants to debug Go applications. The server exposes a set of tools that enable LLMs to initiate, control, and interact with debugging sessions.

You can find an example implementation in EXAMPLE.md.

✨ Features

Initiate a debugging session for a Go program.
Set breakpoints in the code.
Step through the code (step over, step into, step out).
Evaluate expressions within the context of a debugging session.
Inspect variables and stack traces.
Manage multiple debugging sessions.

📦 Installation

Prerequisites

Go 1.21 or higher.
Delve debugger installed (go install github.com/go-delve/delve/cmd/dlv@latest).

Installation

go install github.com/xhd2015/dlv-mcp/cmd/dlv-mcp@latest

💻 Usage Examples

Basic Usage

Start the MCP server:

dlv-mcp --listen :9097

Then configure http://localhost:9097/sse in Cursor or any MCP client.

Check the MCP Server

bunx @modelcontextprotocol/inspector dlv-mcp

Available Tools

Debug Session Management

start_debug: Start a new debugging session.
- program: Path to the Go program to be debugged.
- args: Command-line arguments for the program (optional).
- mode: Debugging mode (debug, test, or exec, default is debug).
terminate_debug: Terminate a debugging session.
- session_id: ID of the debugging session to terminate.
list_debug_sessions: List active debugging sessions.

Breakpoint Management

set_breakpoint: Set a breakpoint in a debugging session.
- session_id: ID of the debugging session to operate on.
- line: Line number of the code where the breakpoint is to be set.
- message: Breakpoint message (optional).

Execution Control

step_in: Step into a method or function call.
- session_id: ID of the debugging session to operate on.
step_out: Step out of the current method or function.
- session_id: ID of the debugging session to operate on.

Expression Evaluation

evaluate_expression: Evaluate an expression within the context of a debugging session.
- session_id: ID of the debugging session to operate on.
- expression: String of the expression to be evaluated.