secrets-audit-mcp について
secrets-audit-mcpは、ソースコード内の認証情報漏えいを検出するMCPサーバーです。コードレビューやCIで利用でき、テキスト、個別ファイル、ディレクトリをスキャンし、該当箇所を伏せ字にしてリスクを報告します。
主な機能
- 01テキスト、ファイル、ディレクトリのスキャン
- 0232種類の認証情報ルールに対応
- 03一般的なディレクトリを除外した再帰スキャン
- 04リスクスコアと重大度の出力
- 05行番号の表示と該当文字列の伏せ字化
- 06依存関係のない単一ファイル実装
活用シーン
- 01コミット前のコードベース検査
- 02変更内容の認証情報漏えい確認
- 03クローンしたリポジトリを開く前の検査
- 04エージェントによるファイル編集時のチェック
MCP 対応
このMCPサーバーは、テキスト、ファイル、ディレクトリをスキャンするツールをクライアントに提供し、構造化されたリスクレポートを返します。検出内容は伏せ字で出力されます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
docker run -i --rm ghcr.io/eltociear/secrets-audit-mcp:1.0.1ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ghcr.io/eltociear/secrets-audit-mcp:1.0.1stdioツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
secrets-audit-mcp
ソースコード内の漏えいした認証情報を検出する MCP サーバーです。依存関係はゼロ。単一ファイルです。
API キー、OAuth トークン、秘密鍵、Webhook、暗号資産ウォレットのシークレットを、30 以上のプロバイダー(AWS、GCP、GitHub、Stripe、OpenAI、Anthropic、Slack、Discord、Telegram、Twilio、SendGrid、Heroku、DigitalOcean、npm、HuggingFace、Replicate、Cloudflare など)にわたって検出します。
skill-audit-mcp(動作パターン)の姉妹プロジェクトです。組み合わせることで、1 つの MCP ツールチェーンでシークレットと動作パターンの両方を検出できます。
理由
ほとんどのシークレットスキャナーは巨大な Go バイナリです(trufflehog、gitleaks)。これは MCP stdio サーバーとして動作する 500 行の Python ファイルなので、どの LLM エージェント(Claude Desktop、Cursor、Windsurf、Cline)からでも scan_directory を呼び出し、ツール呼び出しの応答で構造化されたレポートを取得できます。
使用例:
- CI でのコミット前フック
- エージェント主導のコードレビュー(「この PR で認証情報が漏えいしていないか?」)
- シェルで開く前に、新しくクローンしたリポジトリを監査
- エージェントによるファイル編集時のインラインスキャン
インストール
# 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 ボット/ユーザー/Webhook、Discord ボット/Webhook、Telegram ボット、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(Base で $0.01 USDC)および /audit/url($0.03)をご利用ください。公式 MCP Registry には io.github.eltociear/secrets-audit-mcp として登録されています。
プロフェッショナル監査サービス
同じ作者が運営する Polar の有料サービス(Stripe で決済)です。
- MCP Security Audit Report — $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(1 回あたり $0.005)
同じ運営者による、同じ x402 の決済方式です。clean-read は任意の URL を AI エージェント向けのクリーンな Markdown に変換します。ページを取得し、ナビゲーション、広告、定型文(trafilatura)を取り除いて、タイトルと単語数とともに本文を返します。POST https://eltociear-skill-audit.hf.space/read — Base で $0.005 USDC、登録不要です。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。