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

Related MCP server: MCP-Typescribe

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.