Delve

🚀 Delve-MCP Server

A TypeScript-based MCP server that provides a complete Delve debugger interface for Go programs. This server implements all the main commands and functions of Delve.

🚀 Quick Start

The Delve MCP Server is a TypeScript-based solution that offers a comprehensive Delve debugger interface for Go programs. It enables full implementation of Delve's key commands and features.

✨ Features

Resources

• List and access debugging sessions via delve:// URIs.
• Each session comes with metadata about its type, target, and port.
• Represent session details and status in JSON format.

Tools

Debug, trace, and analyze Go programs using the following commands:

• Debugging commands (debug, attach, exec, test).
• Core dump analysis.
• Program tracing.
• Replay debugging with rr.
• DAP server support.
• Conditional breakpoint management.
• Execution control (continue, step, next).
• Variable inspection and evaluation.
• Backend selection (native, lldb, rr).
• Log configuration.
• Session management.

Environment Setup

Server requirements:

• Go and Delve installed (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 the Delve MCP server:

npm install @dwisiswant0/delve-mcp

🛠️ Development

Install dependencies:

npm install

Build the server:

npm run build

Develop with automatic rebuild:

npm run watch

Configuration

Add server configuration when using with Claude Desktop:

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

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

💻 Available Tools

• debug - Debug a Go program in the current directory or a specified package.
• attach - Attach to a running Go program.
• exec - Execute an executable in a new process.
• test - Run Go tests.
• Other debugging commands.

💻 Usage Examples

Basic Usage

Start a debugging session

{ name: "debug" }

Manage breakpoints

// Set a breakpoint
{ 
  name: "setBreakpoint",
  arguments: { line: 10, file: "main.go" }
}

// Remove a breakpoint
{
  name: "removeBreakpoint",
  arguments: { id: 1 }
}

Check status

{
  name: "evaluate",
  arguments: {
    expression: "a + b",
    frameId: 0
  }
}

📄 License

MIT