Go 进程检查器

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

特性

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

安装

go install github.com/monsterxx03/gospy@latest

用法

CLI 接口

# 交互式终端 UI
sudo gospy top --pid <pid>

# HTTP API 服务器
sudo gospy serve --port 8974

# 获取进程摘要
sudo gospy summary --pid <pid>

# 以 JSON 格式获取进程摘要
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 服务器提供一个 SSE (Server-Sent Events) 端点。 启用方法：

>>> 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/sse   - MCP SSE 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/<pid>/mem）
• 访问 macOS 上的 Mach API

使用 sudo 运行：

sudo gospy top --pid <pid>

对于开发/调试，您可能需要：

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

鸣谢

0.7.0 版本完全从头开始使用 aider 重写，它编写了 >90% 的代码。 另外感谢：

• DeepSeek (R1 + V3 models) - AI 编码助手

总 AI 计算成本：约 2 美元

许可证

MIT - 有关详细信息，请参见 LICENSE 文件。