gospy

[](https://goreportcard.com/report/github.com/monsterxx03/gospy) [](LICENSE) [](https://cursor.com/install-mcp?name=gospy&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0Ojg5NzQvbWNwIn0%3D)

A tool for inspecting and analyzing running Go processes, including goroutine states, memory statistics, and binary information.

• 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

go install github.com/monsterxx03/gospy@latest

# 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

• --pid/-p - Target process ID (required)
• --bin/-b - Path to binary file (optional)
• --json/-j - Output results in JSON format

• GET /goroutines?pid=<pid> - List all goroutines
• GET /memstats?pid=<pid> - Get memory statistics
• GET /runtime?pid=<pid> - Get runtime version info

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 process
• gomemstats - Dump memory stats for a go process
• goruntime - Dump