mcp-secret-scrub

mcp-name: io.github.sudo-ai-git/mcp-secret-scrub

テキスト、ログ、トランスクリプトからシークレットを、エージェントコンテキストに入る前に除去し、値を決して漏らさない、決定的・LLM 不要の MCP サーバー。

LLM なし。ネットワークなし。純粋な構造検出。MIT。クラウンジュエルなし。

解決する問題

生のテキストをエージェントに渡す（または保存する、ツールに渡す）前に、その中に実際のシークレットが含まれているかどうかは、しばしば分かりません。プラットフォームのスクラバーは常にパターンを見逃します—秘密鍵、nvapi- トークン、github_pat_ トークン、ログ途中の api_key= 代入など。そのテキストが LLM コンテキストや永続化されたトランスクリプトに到達したら、シークレットは事実上外部に持ち出されたことになります。

このサーバーは、決定的に次の問いに答えます：

このテキストにはどのシークレットが含まれているか、そしてどこかに送信される前に安全に redact できるか？

Related MCP server: ai-security-gateway-mcp

検出カバレッジ（決定的プロファイル）

スキャンはシークレットの値を決して返しません—型、数、位置のみを返します。これはテストによって強制される厳格な安全契約です。

ツール（MCP）

モード：

• redact（デフォルト）→ [REDACTED:TYPE]

• mask → 最初の4文字と最後の2文字を表示します

• hash → 決定的な SHA-256 プレフィックス（呼び出し間で再現可能）

クイックスタート（stdio）

pip install mcp-secret-scrub
mcp-secret-scrub          # stdio (default)

または、インストール可能なコンソールエントリポイントとして uv/pipx を使用する場合：

pipx install mcp-secret-scrub

MCP クライアント設定：

{ "mcpServers": {
    "secret-scrub": { "command": "mcp-secret-scrub" }
}}

Streamable HTTP（リモート / Smithery 公開可能）

python3 mcp_server.py --http --port 8138   # serves on http://<host>:8138/mcp/

決定性と安全性の保証

• 決定的: 同じ入力 → すべてのモード、すべての呼び出しで同一の出力。

• 漏洩しない: scan_text と scrub_text は元のトークンを決して出力しません。_deterministic_hash は SHA-256（ソルトなし）のため、出力は再現可能です。

• LLM なし、ネットワークなし: 純粋な正規表現 + 到達可能な構造検出。

• 入力安全: 文字列以外の入力はトレースバックではなく、明確なエラーを返します。

検証

• python3 test_detector.py — 14/14 のコアチェック（検出、編集（redaction）、決定性、無漏洩契約、良性/Unicode/空入力、不正モード）

• python3 test_e2e.py — 実際の MCP stdio トランスポートを駆動し、シークレットがワイヤを越えないことを検証します

ライセンスと由来

MIT。sudo-ai-git の決定的・LLM なしのエージェント信頼 MCP ファミリーの一部です（mcp-skill-sec · mcp-verify-claim · mcp-benchmark-hygiene · mcp-secret-scrub）。