shadow-mentor 是做什么的?
针对受监管贷款的5声音AI合规委员会。可放入Claude Desktop / Cursor / Zed / OpenCode / OpenClaw,通过MCP连接。面向美国中型银行的方案:每个合规官席位 / 年 $1,800。开源MIT许可证。
功能
六个MCP工具,将LLM聊天转变为采购可防御的贷款发放合规表面:
shadow_loan_council— 确定性5声音裁决(阻止 / 升级 / 批准)+ 每声音依据 + 风险包 + 应用阈值。FICO < 700 是带有钉定测试的硬编码if。shadow_risk_tools— 机构级风险原语:VaR(历史 / 参数 / MC)、预期缺口、集中度(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分钟内对其进行grep
三个源文件 + 四个测试文件:
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多轮信息泄露 — canary令牌合约测试钉定不变性,即攻击者无法跨工具边界窃取canary
- MCP企业OAuth(EMA) — 可选
SHADOW_REQUIRE_BEARER=1在/api/loan-council上强制执行shadow:council作用域;与OAuth2 / Azure AD声明形状兼容