Go Process Inspector

Go 进程检查器

用于检查和分析正在运行的 Go 进程的工具，包括 goroutine 状态、内存统计信息和二进制文件信息。

功能

• 查看详细的 goroutine 信息（状态、调度信息）
• 分析进程内存统计信息
• 跨平台支持（Linux 和 macOS）
• 用于交互式检查的终端 UI
• 用于编程访问的 HTTP API
• MCP 服务

安装

go install github.com/monsterxx03/gospy@latest

用法

CLI 界面

# 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 命令选项

• --pid/-p - 目标进程 ID（必填）
• --bin/-b - 二进制文件路径（可选）
• --json/-j - 以 JSON 格式输出结果

API 端点

• GET /goroutines?pid=<pid> - 列出所有 goroutine
• GET /memstats?pid=<pid> - 获取内存统计信息
• GET /runtime?pid=<pid> - 获取运行时版本信息

MCP 服务

MCP 服务提供一个 http（streamableHTTP）端点。启用方法：

>>> 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

可用的 MCP 工具：

• goroutines - 转储 Go 进程的 goroutine
• gomemstats - 转储 Go 进程的内存统计信息
• goruntime - 转储 Go 进程的运行时信息
• pgrep - 根据进程名称查找 pid

Cursor 配置

终端 UI 控件

• q - 退出
• r - 刷新数据
• s - 暂停/恢复 top 视图
• / - 搜索/筛选 goroutine

终端 UI 截图

从源代码构建

git clone https://github.com/monsterxx03/gospy.git
cd gospy
make

要求

• Go 1.20+
• Linux 或 macOS（仅限 Apple Silicon）
• Root 权限（访问内存所必需）

Root 权限

gospy 需要 Root 权限才能：

• 读取进程内存（Linux 上的 /proc//mem）
• 在 macOS 上访问 Mach API

使用 sudo 运行：

sudo gospy top --pid <pid>

在开发/调试时，你可能需要：

1. 先构建二进制文件：make
2. 使用 sudo 运行：sudo ./gospy [command]

致谢

Version 0.7.0 使用 aider 从头重写，该工具编写了 >90% 的代码。另有以下协助：

• DeepSeek（R1 + V3 models）- AI 编码助手

AI 计算总成本：约 2 美元

许可证

MIT - 详情请参阅 LICENSE 文件。