Gospy

🚀 Go 进程 inspector

Go 言語で書かれた実行中のプロセスを検査・分析するツールです。goroutine の状態やメモリ統計情報、バイナリ情報を取得できます。

🚀 クイックスタート

このツールを使用することで、実行中の Go プロセスの goroutine 状態やメモリ使用状況を詳細に確認できます。また、HTTP API を通じてプログラムからのアクセスも可能です。

✨ 主な機能

• 詳細な goroutine 情報（状態、スケジューリング情報）の確認
• プロセスのメモリ統計の分析
• クロスプラットフォーム対応（Linux と macOS）
• ターミナル UI によるインタラクティブな検査
• HTTP API によるプログラム的アクセス（MCP サーバ用の sse エンドポイント）

📦 インストール

go install github.com/monsterxx03/gospy@latest

💻 使用例

CLI インターフェース

# インタラクティブなターミナル UI
sudo gospy top --pid <进程 ID>

# HTTP API サーバ
sudo gospy serve --port 8974

# プロセスの概要を取得
sudo gospy summary --pid <进程 ID>

# JSON 形式でプロセスの概要を取得
sudo gospy summary --pid <进程 ID> --json

概要コマンドのオプション

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

API サーバを起動し、ポート 8974 で待機します。
エンドポイント：
  GET /runtime?pid=<PID>     - ランタイム情報を取得
  GET /goroutines?pid=<PID> - goroutine リストを取得
  GET /memstats?pid=<PID>   - メモリ統計を取得
  GET /mcp/sse   - MCP SSE エンドポイント

利用可能な MCP ツール：

• goroutines - Go プロセス内の goroutine をダンプする
• gomemstats - メモリ統計情報をダンプする
• goruntime - ランタイム情報を取得する
• pgrep - プロセス名から PID を検索する

コンフィグは以下の通り：

ターミナル 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 <进程 ID>

開発/デバッグ時には、以下の手順が必要になる場合があります：

1. バイナリをビルドする：make
2. sudo で実行する：sudo ./gospy [コマンド]

🔗 謝辞

バージョン 0.7.0 は完全に最初から書き直され、aider によって 90% 以上のコードが作成されました。その他の支援は以下から得られました：

• DeepSeek（R1 + V3 モデル）- AI コーディングアシスタント

総 AI 計算コスト：約 2 ドル

📄 ライセンス

MIT ライセンスです。詳細については LICENSE ファイルを参照してください。