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.