Community寫作與編輯github.com

alex-jb/shadow-mentor

Shadow — 裝置端AI合規委員會與審計鏈,專為受監管銀行工作流程設計。一個引擎、4個裝置客戶端、5個人物角色包。

shadow-mentor 是什麼?

Shadow Mentor 是一個開源(MIT)的裝置端AI合規工具包,專為受監管銀行環境中的貸放流程設計。它透過MCP協定整合至Claude Desktop、Cursor、Zed、OpenCode和OpenClaw等平台,提供五個人物角色的合規委員會,以確定性方式審查貸款申請。該工具包含六個MCP工具,支援風險評估(如VaR、預期短缺)、跨工作階段記憶回呼、校準監控(Brier分數)與監管歸因(符合CFPB、ECOA、SR 26-2)。Shadow Mentor 強調可審計性與安全性,其程式碼庫包含三個原始檔與四個測試檔,共308項測試全數通過,有效防禦MCPTox、MosaicLeaks等2026年已知MCP威脅。

相容平台✓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 合規委員會,專為受監管貸款業務設計。透過 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 分鐘內通過稽查

三個原始檔 + 四個測試檔:

  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 多輪資訊洩漏 — 金絲雀代幣合約測試固定不變量:攻擊者無法將金絲雀洩漏至工具邊界之外
  • MCP 企業級 OAuth (EMA) — 選擇性啟用的 SHADOW_REQUIRE_BEARER=1 強制於 /api/loan-council 要求 shadow:council 範圍;可搭配 OAuth2 / Azure AD 宣告格式

連結

相關技能