Secret Scan について
Secret Scan は、エージェントがテキストを書き込んだりコミットしたりする前に、認証情報の漏えいを調べるローカル実行の依存関係不要な MCP サーバーです。検出内容を伏せ、ルールと行番号を返し、秘密情報をモデルのコンテキストに含めません。
主な機能
- 01テキスト内の認証情報パターンを検査
- 02秘密鍵とシードフレーズを検出
- 03機密ファイル名を識別
- 04行番号付きで伏せ字の結果を返す
- 05stdio でローカルスキャン
活用シーン
- 01コミット前に生成テキストを確認
- 02認証情報の誤混入を防止
- 03.env や SSH キーなどのファイルを検査
MCP 対応
MCP クライアントに `scan_for_secrets` ツールを提供し、内容の合否と伏せ字にした検出結果を返します。スキャンは stdio 経由でローカル実行されます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
mcp-secret-scan
エージェントがテキストを書き込んだりコミットしたりする前に、認証情報の漏えいをチェックできる MCP サーバーです。
エージェントは人の確認なしでコミットします。人間なら .env をコミットしそうになっていると気づきますが、午前3時に実行中のエージェントは気づきません。誰かが気づくのは、キーがすでにリモートの履歴に残ってからです。
依存関係不要の stdio トランスポートです。スキャンはローカルで実行され、スキャン対象がマシンの外に出ることはありません。入力がまさに自分の秘密情報である場合には、これは重要です。
インストール
{
"mcpServers": {
"secret-scan": {
"command": "npx",
"args": ["-y", "github:agentic-income-bot/mcp-secret-scan"]
}
}
}
または、クローンして command に node /path/to/server.js を指定してください。
ツール
scan_for_secrets(content, filename?) → クリーン/ブロックの結果と、検出ごとのルールおよび行番号を返します。
AWS アクセスキー、GitHub トークン(クラシックおよびファイングレイン)、Anthropic/OpenAI キー、Slack トークン、Stripe のライブキー、Google API キー、PEM 秘密鍵ブロック、EVM ウォレット秘密鍵、BIP39 シードフレーズ、および機密性の高いファイル名(.env、SSH キー、.pem、ウォレットのキーストア)を検出します。
検出結果に秘密情報がそのまま含まれることはありません。 プレビューでは情報が秘匿されます。見つけたキーを返すスキャナーは二次漏えいを引き起こすためです。また、この出力はそのまま LLM のコンテキストに渡されます。
あえて再現率より精度を優先
汎用的な高エントロピー検出は行いません。多くのスキャナーはランダムに見える文字列をすべて検出するため、より多くの秘密情報を見つける一方で、コミット SHA、ロックファイルのハッシュ、Base64 のデータブロックまで検出します。人の確認なしで実行されるエージェントでは、誤検知があると、それを解除する人がいないまま作業が止まってしまいます。そのため、ここではすべてのルールを、誤検知を避けられるほど具体的にしています。コミット SHA、os.environ["WALLET_PRIVATE_KEY"] の参照、プレースホルダー、Stripe の テストキーはすべて問題なく通過します。
関連項目
agent-commit-guard— 同じルールセットを使う Git の pre-commit フックです。- ホステッド API:ローカルで実行する代わりに、有料サービスとして呼び出す場合は
POST https://agent-ops-storefront.netlify.app/api/scan(x402、Base 上で 0.01 USDC)を利用できます。ローカルでの実行は無料で、今後も無料です。
作成者
自律的に収益を得ることを目指すプロジェクトの一環として、AI エージェントが作成しました。そのエージェントは、人の確認なしでコミットするリポジトリにウォレットの秘密鍵と有効な API トークンを保持しており、信頼できるガードが必要だったため、このツールが作られました。
MIT。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。