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.