Gospy
Non-Invasive goroutine inspector
What is Gospy?
Gospy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to non-invasive goroutine inspector
Non-Invasive goroutine inspector
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Non-Invasive goroutine inspector
Use Cases
Maintainer
Works with
Installation
NPM
npx -y gospyManual Installation
npx -y gospyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Gospy
Gospy is a non-invasive Go process inspector that lets AI assistants interrogate live Go programs without attaching a debugger or modifying the target binary. It exposes goroutine states, memory statistics, and runtime version information through an HTTP API and an MCP endpoint, making it ideal for diagnosing concurrency issues, memory pressure, and goroutine leaks in production Go services.
Prerequisites
- Go 1.20 or later installed on the machine running the target process
- Root/sudo privileges (required to read process memory on Linux /proc and macOS Mach APIs)
- Linux or macOS (Apple Silicon) — Windows is not supported
- An MCP client such as Claude Desktop, Cursor, or Cline
- The target Go binary must be running; gospy inspects live processes by PID
Install gospy
Install the gospy binary using the Go toolchain. This places the gospy binary in your $GOPATH/bin, which should be on your PATH.
go install github.com/monsterxx03/gospy@latestStart the HTTP + MCP server
Run gospy in server mode with the --enable-mcp flag. Root privileges are required to access process memory. The server listens on the specified port and exposes both REST endpoints and the MCP streamable-HTTP endpoint at /mcp.
sudo gospy serve --enable-mcp --port 8974Verify the server is running
Confirm the API is live by querying a running Go process. Replace 12345 with the actual PID of your Go application.
curl "http://localhost:8974/goroutines?pid=12345"Configure your MCP client
Add gospy to your MCP client configuration. Because gospy uses streamable HTTP (not stdio), point the client at the /mcp endpoint on the running server.
{
"mcpServers": {
"gospy": {
"url": "http://localhost:8974/mcp"
}
}
}Use the interactive terminal UI (optional)
For human-interactive goroutine inspection you can also use the built-in terminal UI. Press q to quit, r to refresh, s to suspend/resume, and / to search goroutines.
sudo gospy top --pid 12345Gospy Examples
Client configuration
Add gospy to Claude Desktop or Cursor by pointing at the running MCP HTTP endpoint. Start gospy serve first, then add this block.
{
"mcpServers": {
"gospy": {
"url": "http://localhost:8974/mcp"
}
}
}Prompts to try
Once gospy is connected, ask your AI assistant questions about a live Go process.
- "List all goroutines for PID 12345 and identify any that are blocked"
- "Show memory statistics for the Go service running as PID 12345"
- "What Go runtime version is the process with PID 12345 using?"
- "Find the PID of the process named 'myservice' and dump its goroutines"
- "Are there any goroutines in a deadlock state in PID 12345?"Troubleshooting Gospy
Permission denied when starting gospy serve
gospy must be run with sudo because it reads process memory directly. Run: sudo gospy serve --enable-mcp --port 8974
MCP client cannot connect to the gospy endpoint
Ensure gospy serve is already running before starting your MCP client. gospy uses streamable HTTP, not stdio, so the server process must be up independently. Confirm with: curl http://localhost:8974/mcp
goroutines tool returns empty results or an error about the PID
Verify the target process is still running (ps aux | grep <name>) and that you are passing the correct numeric PID. The target must be a Go binary — gospy cannot inspect non-Go processes.
Frequently Asked Questions about Gospy
What is Gospy?
Gospy is a Model Context Protocol (MCP) server that non-invasive goroutine inspector It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Gospy?
Install via npm with the command: npx -y gospy. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Gospy?
Gospy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Gospy free to use?
Yes, Gospy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Gospy Alternatives — Similar Developer Tools Servers
Looking for alternatives to Gospy? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Gospy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Gospy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.