remote-debugger-mcp

module
v1.0.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 24, 2025 License: BSD-3-Clause

README

Remote debugger MCP

This is a Model Context Protocol (MCP) server that provides a set remote debugging tools for profiling Go applications.

Project Overview

Available tools:

  • delve
  • pprof
  • sshexec
  • sysinfo - both local and remote system information via SSH

Adding to coding agents

Claude Code
 claude mcp add --transport http remote-debugger-mcp http://localhost:8899/mcp
Gemini CLI
gemini mcp add remote-debugger-mcp http://localhost:8899/mcp -t http

Running the Server

You need to build it once using the following command:

make

then just

build/remote-debugger-mcp

Tools usage

delve

Running application with delve debugger

dlv debug --accept-multiclient --headless --listen=:2345

or even with PID (for example, 862262)

dlv attach 862262 --accept-multiclient --headless --listen=:2345

Sample agent usage

delve Command=help
pprof

Running application with profiling

See pprof documentation for details on how to run your application with profiling enabled.

Sample agent usage

List available pprof profiles for port 8899

or

pprof Host=192.168.4.15 Profile=heap 

or even

Run available pprof profiles for host 192.168.4.15 and aggregate data
sshexec

Kill specific PID

sshexec Host=192.168.1.100 KillPID=12345

Kill by process name

sshexec Host=192.168.1.100 KillByName=remote-debugger-mcp

Kill with specific signal

sshexec Host=192.168.1.100 KillByName=myapp KillSignal=KILL
Sysinfo
sysinfo

or

sysinfo Host=192.168.4.15
Combined usage (tested on Claude)
 Build this project locally and then transfer it to remote host using sshexec tool. Run it there with -bind 192.168.4.15:8899. Then fetch profiling information using pprof tool, show it here, terminate 
  remote binary.

Similar projects

Directories

Path Synopsis
cmd
debugger command
pkg

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL