About Gospy
Gospy is an MCP server published by monsterxx03 in the Developer Tools category: non-Invasive goroutine inspector.
The repository has 97 stars and 6 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/monsterxx03/gospyThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Gospy
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 8 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
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 LICENSE file for details.
README fetched from the repository 8 hours ago. The original is authoritative.