secrets-audit-mcp

secrets-audit-mcp

用于检测源代码中泄露凭据的 MCP 服务。零依赖。单文件。

可检测 30 多家服务提供商（AWS、GCP、GitHub、Stripe、OpenAI、Anthropic、 Slack、Discord、Telegram、Twilio、SendGrid、Heroku、DigitalOcean、npm、 HuggingFace、Replicate、Cloudflare 等）的 API 密钥、OAuth 令牌、私钥、Webhook 和加密钱包 机密信息。

与 skill-audit-mcp （行为模式）配套使用——两者结合，可通过一套 MCP 工具链覆盖机密信息和行为。

---

为什么使用

大多数机密扫描器都是庞大的 Go 二进制程序（trufflehog、gitleaks）。这是一个 500 行的 Python 文件，可作为 MCP stdio 服务运行，因此任何 LLM Agent （Claude Desktop、Cursor、Windsurf、Cline）都能调用 scan_directory，并在工具调用响应中 获取结构化报告。

使用场景：

• CI 中的提交前钩子
• Agent 驱动的代码审查（“这个 PR 是否泄露了凭据？”）
• 在终端中打开刚克隆的仓库前进行审计
• Agent 编辑文件时进行内联扫描

---

安装

# Python (recommended)
git clone https://github.com/eltociear/secrets-audit-mcp.git
python3 secrets-audit-mcp/server.py  # stdio MCP server

# Or via npm wrapper (TBD)
npm install -g @eltociear/secrets-audit-mcp

MCP 客户端配置

{
  "mcpServers": {
    "secrets-audit": {
      "type": "stdio",
      "command": "python3",
      "args": ["/path/to/secrets-audit-mcp/server.py"]
    }
  }
}

---

工具

工具	使用场景
scan	扫描内联文本/内容
scan_file	扫描单个文件
scan_directory	递归扫描目录（跳过 .git、node_modules、__pycache__ 等）

所有工具都会返回风险评分（0-100）、严重性级别（CRITICAL/HIGH/MEDIUM/LOW/SAFE）， 以及包含行号和脱敏匹配内容的逐项发现详情。

---

覆盖范围

服务提供商（共 32 条规则）：

• 云服务：AWS 访问密钥/机密密钥、GCP API 密钥 + 服务账号 JSON、Heroku、DigitalOcean、Cloudflare
• 代码托管/CI：GitHub PAT/OAuth/App/Refresh/Fine-grained、npm 令牌、Docker Hub PAT
• 支付：Stripe 机密密钥 + 受限密钥
• 通信：Slack bot/user/webhook、Discord bot/webhook、Telegram bot、Twilio、SendGrid、Mailgun
• AI/ML：OpenAI、Anthropic、HuggingFace、Replicate
• Web3：Ethereum 私钥（上下文感知）、Alchemy、Infura
• 密钥：RSA / EC / OpenSSH / PGP / 通用 PEM 私钥
• 通用：JWT、apikey="..." 启发式规则、通用机密赋值

每个匹配项在返回前都会脱敏（AKIA***MPLE），因此报告本身不会在后续 LLM 处理环节中泄露机密信息。

---

CI 用法

- name: Secrets audit
  run: |
    python3 server.py <<EOF | jq -r '.result.content[0].text'
    {"jsonrpc":"2.0","id":1,"method":"tools/call",
     "params":{"name":"scan_directory","arguments":{"path":"."}}}
    EOF

正式版 GitHub Action 即将以 eltociear/secrets-audit-action@v1 发布。

---

配套项目 — skill-audit-mcp

skill-audit-mcp 可检测 行为恶意软件模式（下载并执行、提示词注入、凭据外泄）。同时运行两者即可实现全面覆盖：

层	工具	检测内容
静态行为	skill-audit-mcp	curl-pipe-sh、数据外泄、提示词注入（68 种模式）
静态机密信息	secrets-audit-mcp	泄露的密钥/令牌/PEM（32 条规则）

---

订阅 — security pulse

Polar.sh — Security Pulse Monthly 每月发布简报，介绍新的 MCP 服务漏洞、secrets-audit-mcp 规则更新和缓解措施手册。每月 5 美元。

Polar.sh — Pro Audit Stack 包含 50 次付费扫描额度 + Discord + 自定义规则提交。每月 20 美元。

---

许可证

MIT。参见 LICENSE。

免费 MCP 与付费 x402

此 MCP 服务免费。对于服务器端、批处理或无需安装的场景，同一款扫描器提供按次付费的 x402 HTTP API：POST https://eltociear-secrets-audit.hf.space/audit（$0.01 USDC on Base）和 /audit/url（$0.03）。已收录于官方 MCP Registry，名称为 io.github.eltociear/secrets-audit-mcp。

专业审计服务

由同一位作者维护——通过 Polar 提供付费服务（Stripe 结账）：

• MCP 安全审计报告 — $5 — 对你的 MCP 服务进行一次性审计：涵盖 68 种攻击模式，并提供按严重程度评级的 PDF 报告和具体修复建议。
• Security Pulse — $5/mo（年付 $50）— 每月简报，介绍最新披露的 MCP 服务漏洞、对 100 多个受跟踪代码仓库的扫描统计数据，以及缓解方案。
• Pro Audit Stack — $20/mo — 适用于在 CI/CD 中运行 MCP 服务的团队：每月 50 次托管扫描、Discord 访问权限，以及针对漏洞问题的 24 小时 SLA。

完整目录：polar.sh/eltociear

另有上线服务：clean-read（每次调用 $0.005）

由同一运营方提供，使用相同的 x402 支付通道：clean-read 可将任意 URL 转换为适合 AI Agent 使用的简洁 Markdown——抓取页面、移除导航栏、广告和样板内容（trafilatura），并返回带有标题和字数统计的正文。POST https://eltociear-skill-audit.hf.space/read — 每次调用 $0.005 USDC on Base，无需注册。