Remote debugger MCP
This is a Model Context Protocol (MCP) server that provides a remote debugger tool for profiling Go applications using pprof.
Project Overview
Available tools:
- delve
- pprof
- 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
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