Ghosthunt

GhostHunt

マシン上に漏えいしたシークレットをすべて見つけます。

GhostHunt は、開発用マシンをスキャンして、確認し忘れた場所に潜む API キー、トークン、認証情報を見つける MCP サーバーです。プロジェクト内に散在する .env ファイル、シェルの履歴、AWS／SSH／Docker の設定などが対象です。

すべてローカルで実行されます。データがマシンから外部に送信されることはありません。

スキャン対象

• 環境ファイル — ホームディレクトリ以下にある .env、.env.local、.env.production などをすべて再帰的に検索します
• AWS 認証情報 — ~/.aws/credentials とセッショントークン
• SSH キー — ~/.ssh/ にある保護されていない秘密鍵
• Docker 設定 — ~/.docker/config.json にあるレジストリ認証トークン
• npm／PyPI トークン — ~/.npmrc、~/.pypirc にある認証トークン
• GitHub CLI — ~/.config/gh/hosts.yml にある OAuth トークン
• シェルの履歴 — bash、zsh、fish のコマンドに貼り付けられた API キー
• Kubernetes — ~/.kube/config の認証情報
• Netrc — ~/.netrc のパスワード
• 35 種類以上のシークレットパターン — AWS、Stripe、GitHub、OpenAI、Anthropic、Google、Slack、Twilio、SendGrid、データベース接続文字列、秘密鍵など

インストール

Claude Desktop

Claude Desktop の設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "ghosthunt": {
      "command": "npx",
      "args": ["-y", "ghosthunt"]
    }
  }
}

Claude Desktop を再起動します。その後、Claude に 「マシン上に漏えいしたシークレットがないかスキャンして」 と尋ねます。

直接使用する場合

npx ghosthunt

ツール

scan_secrets

詳細なフルスキャンを実行します。見つかった項目をすべて、ファイルパス、行番号、重大度、対処手順とともに返します。

プロンプトの例：「GhostHunt のフルスキャンを実行して、すべて表示して」

scan_summary

簡易的なヘルスチェックを実行します。ヘルススコア（0～100）と重大度別の件数を返します。問題があるかどうかを確認するために、まず実行してください。

プロンプトの例：「GhostHunt で簡単なヘルスチェックをして」

出力例

# GhostHunt Scan Report

**Health Score: 37/100** (Critical)

- Secrets found: **12**
- Critical: 3 | High: 5 | Medium: 2 | Low: 2
- Locations scanned: 47
- Scan time: 142ms

## Environment Files (.env)

- **[CRITICAL]** Stripe Live Secret Key
  - File: `/Users/you/project-a/.env:4`
  - Context: `STRIPE_SECRET_KEY`
  - Value: `sk_l****_8xQ`

- **[CRITICAL]** OpenAI API Key
  - File: `/Users/you/side-project/.env.local:12`
  - Context: `OPENAI_API_KEY`
  - Value: `sk-p****kFJ9`

## Shell History

- **[HIGH]** Bearer Token in Header
  - File: `/Users/you/.zsh_history:8847`
  - Context: `curl -H "Authorization: Bearer sk_live_...`
  - Value: `sk_l****_m3K`

## Recommendations

1. **Rotate critical secrets immediately.** Any API key marked CRITICAL
   should be revoked and regenerated from the provider's dashboard.
2. **Clear your shell history** of sensitive commands.
3. **Audit your .env files.** Ensure they are in .gitignore.

ヘルススコア

スコアは 100 から始まり、GhostHunt が見つけた内容に応じて減点されます。

検出項目	減点
致命的なシークレット	-15
重大度：高	-8
重大度：中	-3
重大度：低	-1

スコアが 50 未満の場合、すぐに対処が必要なシークレットがあります。

プライバシー

GhostHunt はすべてローカルマシン上で実行されます。以下の動作は行いません。

• データをサーバーに送信する
• 外部に接続したり、使用状況を追跡したりする
• スキャン結果をどこかに保存する
• インターネットにアクセスする

シークレットはマシン上に留まります。スキャン結果は Claude との会話に留まります。

ライセンス

MIT