Community写作与编辑github.com

shadow-mentor

Shadow — 面向受监管银行工作流程的本地AI委员会与审计链。一个引擎,4个设备客户端,5个人格包。

shadow-mentor 是什么?

Shadow Mentor 是一个开源的AI合规咨询系统,专为受监管的贷款发放流程设计,可无缝集成到Claude Desktop、Cursor、Zed、OpenCode和OpenClaw等MCP托管平台。它通过六个MCP工具提供确定性的五重声音裁决(阻止/升级/批准),并包含风险分析、跨会话记忆召回、校准统计、场景枚举和来源追溯等功能。所有工具均在进程内运行,无网络调用,确保了安全性和可审计性,特别适合银行合规团队在10分钟内通过代码审查。该系统防御了2026年已知的MCP威胁,如OX Security供应线攻击、MCPTox基准测试和MosaicLeaks信息泄露,并支持企业OAuth认证。项目包含308个通过测试,Shadow代理评分87±3,定价为每个合规官员席位每年1800美元。

兼容平台✓Claude Code~Codex CLI✓Cursor✓Antigravity✓OpenCode
npx skills add alex-jb/shadow-mentor

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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

三个源文件 + 四个测试文件:

  1. lib/audit-guardrail.js — 12模式正则输出门(模式层安全)
  2. lib/run-loan-council.js — if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... }(确定性底层)
  3. 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声明形状兼容

链接

相关技能