shadow-mentor 是做什麼的?
5 聲部 AI 合規委員會,專為受監管貸款業務設計。透過 MCP 嵌入 Claude Desktop / Cursor / Zed / OpenCode / OpenClaw。美國中型銀行報價:每位合規官每年 1,800 美元。採 MIT 開源授權。
功能說明
六個 MCP 工具,將 LLM 對話轉化為採購部門可辯護的貸款審查合規介面:
shadow_loan_council— 確定性 5 聲部裁決(封鎖 / 升級 / 核准),附各聲部理由、風險封包及門檻套用。FICO < 700 為寫死的if陳述句,並附固定測試。shadow_risk_tools— 機構風險原語:VaR(歷史 / 參數 / Monte Carlo)、預期短缺、集中度(HHI / Gini)、產業曝險、相關性(Pearson / Spearman / EWMA)、因子曝險、Beta 分解shadow_recall— 以人物角色及情境為鍵的跨工作階段記憶回呼shadow_calibration— 各人物角色的 Brier 校準統計(用於 SR 26-2 模型風險監控)shadow_scenarios— 表面列舉(5 人物角色 × 4 情境 × 4 裝置客戶端 × 2 提供者)shadow_traceability— 任何門檻的來源歸屬(BRD vs. 補充說明 vs. 風險偏好備忘錄),符合 CFPB / ECOA / SR 26-2
所有工具均於處理程序中執行,工具本體無任何網路呼叫。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— 28 項合約測試,涵蓋 MCPTox §3 攻擊類別及 MosaicLeaks 覆蓋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 代理評分 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 的工具本體僅呼叫凍結的
lib/模組,無未受信任的 shell 輸入進入工具本體 - MCPTox 基準測試(arXiv 2508.14925)— Shadow 回傳嚴格 JSON 列舉裁決,而非敘述;投毒的說明無法擴大模式以外的回應表面
- MosaicLeaks 多輪資訊洩漏 — 金絲雀代幣合約測試固定不變量:攻擊者無法將金絲雀洩漏至工具邊界之外
- MCP 企業級 OAuth (EMA) — 選擇性啟用的
SHADOW_REQUIRE_BEARER=1強制於/api/loan-council要求shadow:council範圍;可搭配 OAuth2 / Azure AD 宣告格式