Ghosthunt

GhostHunt

找出机器上所有泄露的机密。

GhostHunt 是一个 MCP 服务，可扫描你的开发机器，查找藏在你可能忘了检查的地方的 API 密钥、令牌和凭据：散落在各个项目中的 .env 文件、Shell 历史记录、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 令牌
• Shell 历史记录 — 粘贴到 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