Delve MCP

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A TypeScript-based MCP server providing a complete interface to the Delve debugger for Go programs, enabling debugging, tracing, and analyzing Go code through natural language commands.

Related MCP Servers

language-server-mcp
alexwohletz
A
security
A
license
A
quality
TypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics.
Last updated -
3
13
MIT License
MCP Server Playground
psaboia
A
security
F
license
A
quality
A TypeScript-based MCP server designed for experimentation and integration with Calude Desktop and Cursor IDE, offering a modular playground for extending server capabilities.
Last updated -
2
1,133
4
JavaScript
mcp-gopls
hloiseaufcms
-
security
-
license
-
quality
A Model Context Protocol (MCP) server that allows AI assistants like Claude to interact with Go's Language Server Protocol (LSP) and benefit from advanced Go code analysis features.
Last updated -
Go
Apache 2.0
FastMCP
yamato-snow
-
security
A
license
-
quality
A TypeScript framework for building MCP servers with client session management capabilities, supporting tools definition, authentication, image content, logging, and error handling.
Last updated -
6,371
TypeScript
MIT License

View all related MCP servers