mcpField
G
Go Process Inspector

Go Process Inspector

Local
github.com/monsterxx03Developer Tools97Updated 72w ago
Repository

About Go Process Inspector

Go Process Inspector (gospy) inspects running Go processes, showing goroutine states, memory statistics and binary information. It offers a terminal UI, an HTTP API and an MCP endpoint, aimed at Go developers debugging and analyzing live processes.

Key features

  1. 01View goroutine status and scheduling information
  2. 02Analyze process memory statistics
  3. 03Interactive terminal user interface
  4. 04HTTP API for programmatic access
  5. 05Streamable HTTP MCP endpoint

Use cases

  1. 01Debugging goroutine behavior in a running Go service
  2. 02Querying memory and runtime details of a Go process from an AI assistant
  3. 03Analyzing resource usage of Go processes on Linux or macOS

MCP support

When started with --enable-mcp, it serves MCP over an HTTP endpoint and exposes goroutines, gomemstats, goruntime and pgrep tools to clients.

#golang#goroutine#profiling#aider#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Go Process Inspector

Go Report Card License Install MCP Server

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 goroutines
  • GET /memstats?pid=<pid> - Get memory statistics
  • GET /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 process
  • gomemstats - Dump memory stats for a go process
  • goruntime - Dump runtime info for a go process
  • pgrep - Find pid from process name

Config in cursor

README image

Terminal UI Controls
  • q - Quit
  • r - Refresh data
  • s - Suspend/Resume top view
  • / - Search/filter goroutines
Terminal UI Screenshot

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:

  1. Build the binary first: make
  2. 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.