mcp-secret-scrub

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

결정적(no-LLM) MCP 서버: 텍스트, 로그, 트랜스크립트에서 비밀을 정리하여 에이전트 컨텍스트에 들어가기 전에 제거하고, 값을 절대 유출하지 않습니다.

LLM 없음. 네트워크 없음. 순수 구조 탐지. MIT. 크라운-주얼 없음.

해결하는 문제

원시 텍스트를 에이전트에 넘기기 전(또는 저장하거나 도구에 전달하기 전)에 그 안에 실제 비밀이 들어 있는지 알 수 없는 경우가 많습니다. 플랫폼 스크러버는 패턴을 자주 놓칩니다 — 개인 키, nvapi- 토큰, github_pat_ 토큰, 로그 중간의 api_key= 할당. 해당 텍스트가 LLM 컨텍스트나 영구 저장된 트랜스크립트에 도달하면 비밀은 사실상 유출된 것입니다.

이 서버는 결정적으로 다음과 같이 답합니다:

이 텍스트에 어떤 비밀이 있으며, 어디로 가기 전에 안전하게 삭제할 수 있나요?

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 핵심 검사 (탐지, 삭제, 결정성, 비유출 계약, 정상/유니코드/빈 입력, 잘못된 모드)

• python3 test_e2e.py — 실제 MCP stdio 전송을 구동하고 비밀이 와이어를 통해 전송되지 않음을 단언합니다.

라이선스 및 출처

MIT. sudo-ai-git 결정적 no-LLM 에이전트 신뢰 MCP 제품군의 일부입니다 (mcp-skill-sec · mcp-verify-claim · mcp-benchmark-hygiene · mcp-secret-scrub).