gospy
If you are the rightful owner of gospy and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Go Process Inspector is a tool for inspecting and analyzing running Go processes, including goroutine states, memory statistics, and binary information.
Go Process Inspector
A tool for inspecting and analyzing running Go processes, including goroutine states, memory statistics, and binary information.
Features
- View detailed goroutine information (status, scheduling info)
- Analyze process memory statistics
- Cross-platform support (Linux and macOS)
- Terminal UI for interactive inspection
- HTTP API for programmatic access
- mcp server
Installation
go install github.com/monsterxx03/gospy@latest
Usage
CLI Interface
# Interactive terminal UI
sudo gospy top --pid <pid>
# HTTP API server
sudo gospy serve --port 8974
# Get process summary
sudo gospy summary --pid <pid>
# Get process summary in JSON format
sudo gospy summary --pid <pid> --json
Summary Command Options
--pid/-p- Target process ID (required)--bin/-b- Path to binary file (optional)--json/-j- Output results in JSON format
API Endpoints
GET /goroutines?pid=<pid>- List all goroutinesGET /memstats?pid=<pid>- Get memory statisticsGET /runtime?pid=<pid>- Get runtime version info
MCP Server
The MCP server provides an http (streamableHTTP) endpoint. To enable:
>>> sudo gospy serve --enable-mcp --port 8974
Starting API server on port 8974
Endpoints:
GET /runtime?pid=<PID> - Get runtime info
GET /goroutines?pid=<PID> - Get goroutines list
GET /memstats?pid=<PID> - Get memory stats
GET /mcp - MCP http endpoint
Available MCP tools:
goroutines- Dump goroutines for a go processgomemstats- Dump memory stats for a go processgoruntime- Dump runtime info for a go processpgrep- Find pid from process name
Config in cursor
Terminal UI Controls
q- Quitr- Refresh datas- Suspend/Resume top view/- Search/filter goroutines
Terminal UI Screenshot
Building from Source
git clone https://github.com/monsterxx03/gospy.git
cd gospy
make
Requirements
- Go 1.20+
- Linux or macOS (Apple Silicon only)
- Root privileges (required for memory access)
Root Privileges
gospy requires root privileges to:
- Read process memory (/proc/
/mem on Linux) - Access Mach APIs on macOS
Run with sudo:
sudo gospy top --pid <pid>
For development/debugging, you may want to:
- Build the binary first:
make - Run with sudo:
sudo ./gospy [command]
Credits
Version 0.7.0 was completely rewritten from scratch with aider, which wrote >90% of the code. Additional assistance from:
- DeepSeek (R1 + V3 models) - AI coding assistant
Total AI compute cost: ~$2 USD
License
MIT - See file for details.
