Was macht shadow-mentor?
5-stimmiger KI-Compliance-Rat für regulierte Kreditvergabe. Einbindbar in Claude Desktop / Cursor / Zed / OpenCode / OpenClaw über MCP. Pitch für eine mittlere US-Bank: 1.800 $ / Compliance-Officer-Sitz / Jahr. Open Source MIT.
Was es tut
Sechs MCP-Tools, die einen LLM-Chat in eine beschaffungsfähige Compliance-Oberfläche für die Kreditvergabe verwandeln:
shadow_loan_council— Deterministisches 5-stimmiges Urteil (blockieren / eskalieren / genehmigen) + Begründung pro Stimme + Risikopaket + angewendete Schwellenwerte. FICO < 700 ist ein hartcodiertesifmit einem festen Test.shadow_risk_tools— Institutionelle Risikoprimitive: VaR (historisch / parametrisch / MC), Expected Shortfall, Konzentration (HHI / Gini), Sektor-Exposure, Korrelation (Pearson / Spearman / EWMA), Faktor-Exposures, Beta-Zerlegungshadow_recall— Sitzungsübergreifender Speicher-Abruf, abgestimmt auf Persona + Szenarioshadow_calibration— Brier-Kalibrierungsstatistiken pro Persona (für SR 26-2 Modellrisiko-Überwachung)shadow_scenarios— Aufzählung der Oberfläche (5 Personas × 4 Szenarien × 4 Geräte-Clients × 2 Anbieter)shadow_traceability— Quellenangabe für jeden Schwellenwert (BRD vs. Addendum vs. Risikoappetit-Notiz) gemäß CFPB / ECOA / SR 26-2
Alle Tools laufen im Prozess. Kein Netzwerkaufruf innerhalb des Tool-Bodys. Adverse-Action-Codes AA01–AA05 entsprechen CFPB Bulletin 2024-09.
Warum das Beschaffungsteam einer Bank es in 10 Minuten überprüfen kann
Drei Quelldateien + vier Testdateien:
lib/audit-guardrail.js— 12-Muster-Regex-Ausgangstor (Schema-Ebenen-Sicherheit)lib/run-loan-council.js—if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... }(Determinismus-Schwelle)installer/tools.json— eingefrorener Installationsziel × Bereichskatalog (EMA-bereit)
Testoberfläche:
test/mcptox-canary.test.js— 28 Vertragstests zu MCPTox §3 Angriffskategorien + MosaicLeaks-Abdeckungtest/oauth-scaffold.test.js+test/oauth-loan-council-wiring.test.js— Enterprise Managed Auth Bereichskatalog + Live-Verdrahtungtest/glm-call.test.js— Multi-Anbieter-Vertrag (Anthropic + GLM-5.2)test/tools-catalog.test.js— Katalog-Drift-Tor
308/308 Tests bestanden. Shadow Agentic Score 87 ± 3 (n=6).
Schnellinstallation
git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs # siehe, welche MCP-Hosts erkannt werden
node bin/install.mjs --host cursor --dry-run # Vorschau der zusammengeführten Konfiguration
node bin/install.mjs --host cursor # schreiben
Verteidigt gegen benannte MCP-Bedrohungen von 2026
- OX Security MCP STDIO Supply-Chain Advisory (Mai 2026) — Shadows Tool-Bodies rufen nur eingefrorene
lib/-Module auf; keine nicht vertrauenswürdige Shell-Eingabe erreicht einen Tool-Body - MCPTox-Benchmark (arXiv 2508.14925) — Shadow gibt strikte JSON-Enum-Urteile zurück, keine Erzählungen; vergiftete Beschreibungen können die Antwortoberfläche nicht über das Schema hinaus erweitern
- MosaicLeaks Multi-Turn Informationsleckage — Canary-Token-Vertragstests stellen die Invariante sicher, dass ein Angreifer keinen Canary über die Tool-Grenze exfiltrieren kann
- MCP Enterprise OAuth (EMA) — Opt-in
SHADOW_REQUIRE_BEARER=1erzwingt denshadow:council-Bereich auf/api/loan-council; funktioniert mit OAuth2 / Azure AD-Anspruchsformen
Links
- Repository: https://github.com/alex-jb/shadow-mentor
- Veröffentlichung: https://github.com/alex-jb/shadow-mentor/releases/tag/v1.2.0
- Vergleich mit Anthropic FS Agents:
docs/positioning-vs-anthropic-fs.md - Prinzipien:
docs/principles/schema-layer-safety.md·docs/principles/determinism-floor.md - Lizenz: MIT