shadow-mentor은(는) 무엇을 하나요?
규제된 대출을 위한 5-음성 AI 규정 준수 협의회. Claude Desktop / Cursor / Zed / OpenCode / OpenClaw에 MCP를 통해 드롭인하여 사용하세요. 중간 규모 미국 은행 제안: 규정 준수 책임자 좌석당 연간 1,800달러. 오픈 소스 MIT.
기능
LLM 채팅을 조달 부서가 방어할 수 있는 대출 실행 규정 준수 표면으로 변환하는 여섯 개의 MCP 도구:
shadow_loan_council— 결정론적 5-음성 판결(차단 / 에스컬레이션 / 승인) + 음성별 근거 + 위험 패킷 + 적용된 임계값. FICO < 700은 고정된 테스트와 함께 하드코딩된if문입니다.shadow_risk_tools— 기관 위험 프리미티브: VaR(역사적 / 파라메트릭 / 몬테카를로), 예상 손실, 집중도(HHI / 지니), 섹터 노출, 상관관계(피어슨 / 스피어만 / EWMA), 팩터 노출, 베타 분해shadow_recall— 페르소나 + 시나리오로 키가 지정된 교차 세션 메모리 복원shadow_calibration— 페르소나별 Brier 보정 통계(SR 26-2 모델 위험 모니터링용)shadow_scenarios— 표면 열거(5 페르소나 × 4 시나리오 × 4 디바이스 클라이언트 × 2 공급자)shadow_traceability— CFPB / ECOA / SR 26-2에 따른 모든 임계값(BRD vs 부록 vs 위험 선호도 노트)에 대한 소스 출처 속성
모든 도구는 프로세스 내에서 실행됩니다. 도구 본문 내부에서 네트워크 호출이 없습니다. AA01–AA05 불이익 조치 코드는 CFPB 게시판 2024-09를 준수합니다.
은행 조달 부서가 10분 안에 검토할 수 있는 이유
세 개의 소스 파일 + 네 개의 테스트 파일:
lib/audit-guardrail.js— 12-패턴 정규식 출력 게이트(스키마 계층 안전성)lib/run-loan-council.js—if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... }(결정론적 최소값)installer/tools.json— 고정된 설치 대상 × 범위 카탈로그(EMA 대비)
테스트 표면:
test/mcptox-canary.test.js— MCPTox §3 공격 카테고리 + MosaicLeaks 적용 범위를 다루는 28개의 계약 테스트test/oauth-scaffold.test.js+test/oauth-loan-council-wiring.test.js— 엔터프라이즈 관리 인증 범위 카탈로그 + 라이브 배선test/glm-call.test.js— 다중 공급자 계약(Anthropic + GLM-5.2)test/tools-catalog.test.js— 카탈로그 표류 게이트
308/308 테스트 통과. Shadow Agentic Score 87 ± 3 (n=6).
빠른 설치
git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs # 감지된 MCP 호스트 확인
node bin/install.mjs --host cursor --dry-run # 병합된 설정 미리보기
node bin/install.mjs --host cursor # 쓰기
명명된 2026 MCP 위협 방어
- OX Security MCP STDIO 공급망 권고(2026년 5월) — Shadow의 도구 본문은 frozen
lib/모듈만 호출합니다. 신뢰할 수 없는 셸 입력이 도구 본문에 도달하지 않습니다. - MCPTox 벤치마크(arXiv 2508.14925) — Shadow는 엄격한 JSON 열거형 판결을 반환하며, 서술형이 아닙니다. 오염된 설명이 스키마를 넘어 응답 표면을 확장할 수 없습니다.
- MosaicLeaks 다중 턴 정보 유출 — canary-토큰 계약 테스트는 공격자가 도구 경계를 넘어 canary를 유출할 수 없다는 불변성을 고정합니다.
- MCP 엔터프라이즈 OAuth(EMA) — 옵트인
SHADOW_REQUIRE_BEARER=1는/api/loan-council에shadow:council범위를 적용합니다. OAuth2 / Azure AD 클레임 형식과 함께 작동합니다.
링크
- 저장소: https://github.com/alex-jb/shadow-mentor
- 릴리스: https://github.com/alex-jb/shadow-mentor/releases/tag/v1.2.0
- Anthropic FS 에이전트와의 비교:
docs/positioning-vs-anthropic-fs.md - 원칙:
docs/principles/schema-layer-safety.md·docs/principles/determinism-floor.md - 라이선스: MIT