delve-mcp

MCP server for Delve debugger integration

This is a TypeScript-based MCP server that provides a complete interface to the Delve debugger for Go programs. It implements all major Delve commands and capabilities through MCP tools.

Features

Resources

List and access debug sessions via delve:// URIs
Each session has metadata about its type, target, and port
JSON representation for session details and state

Tools

Debug, trace, and analyze Go programs with:

Debug commands (debug, attach, exec, test)
Core dump analysis
Program tracing
Replay debugging with rr
DAP server support
Breakpoint management with conditions
Execution control (continue, step, next)
Variable inspection and evaluation
Backend selection (native, lldb, rr)
Logging configuration
Session management

Environment Setup

The server requires:

Go installed with Delve (go install github.com/go-delve/delve/cmd/dlv@latest)
For replay functionality: Mozilla rr (https://github.com/mozilla/rr)
Node.js and npm

Installation

To install Delve MCP server:

npm install @dwisiswant0/delve-mcp

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Configuration

To use with Claude Desktop, add the server config:

On Linux: ~/.config/Claude/claude_desktop_config.json.
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json.
On Windows: %APPDATA%/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "delve-mcp": {
      "command": "/path/to/delve-mcp/build/index.js"
    }
  }
}

Available Tools

Debug Commands

debug - Debug a Go package in current directory or specified package
attach - Attach to a running process by PID
exec - Execute and debug a precompiled binary
test - Debug tests in current package or specified package
core - Examine a core dump file with associated executable
dap - Start a Debug Adapter Protocol (DAP) server
replay - Replay an rr trace recording
trace - Trace program execution with function matching

Control Commands

setBreakpoint - Set a breakpoint with optional condition
removeBreakpoint - Remove an existing breakpoint
continue - Continue program execution
next - Step over to next line
step - Step into function call
stepout - Step out of current function
variables - List local variables in current scope
evaluate - Evaluate expression in current scope

Configuration Commands

version - Get Delve version information
setBackend - Configure debug backend (native, lldb, rr)
configureLogging - Configure debug logging components

Usage Examples

Starting a Debug Session

// Debug current package
{ name: "debug" }

// Debug with specific package and build flags
{
  name: "debug",
  arguments: {
    package: "./cmd/myapp",
    buildFlags: "-tags=integration"
  }
}

Managing Breakpoints

// Set a breakpoint
{
  name: "setBreakpoint",
  arguments: {
    sessionId: "abc123",
    file: "main.go",
    line: 42,
    condition: "count > 5"
  }
}

Inspecting State

// List variables
{
  name: "variables",
  arguments: {
    sessionId: "abc123"
  }
}

// Evaluate expression
{
  name: "evaluate",
  arguments: {
    sessionId: "abc123",
    expr: "myVar.Field"
  }
}

License

MIT.

Delve