CommunitySchreiben & Editierengithub.com

alex-jb/shadow-mentor

Shadow – KI-Rat auf dem Gerät und Audit-Kette für regulierte Banking-Workflows. Ein Motor, 4 Geräte-Clients, 5 Persona-Pakete.

Was ist shadow-mentor?

Shadow Mentor ist ein KI-basierter Compliance-Rat, der aus fünf synthetischen Stimmen (Personas) besteht und für regulierte Kreditvergabeprozesse entwickelt wurde. Es integriert sich über das MCP-Protokoll in Claude Desktop, Cursor, Zed, OpenCode und OpenClaw und bietet sechs Tools, die eine LLM-Chat-Oberfläche in eine prüfbare Compliance-Umgebung für die Kreditvergabe verwandeln. Die Tools umfassen einen deterministischen Rat (Sperren/ Eskalieren/ Genehmigen), Risikoprimitive (VaR, Expected Shortfall, Konzentration u.a.), Sitzungsübergreifende Erinnerung, Kalibrierungsstatistiken und Nachvollziehbarkeit von Schwellenwerten gemäß CFPB / ECOA / SR 26-2. Die Architektur ist auf Sicherheit ausgelegt: Die Tool-Bodies rufen nur eingefrorene Bibliotheksmodule auf, führen keine Netzwerkanfragen während der Ausführung aus und sind gegen bekannte Bedrohungen wie MCPTox, MosaicLeaks und OAuth-Angriffe geschützt. Es ist Open Source (MIT), hat 308/308 Tests bestanden und erreicht einen Shadow Agentic Score von 87 ± 3.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor✓Antigravity✓OpenCode
npx skills add alex-jb/shadow-mentor

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 hartcodiertes if mit 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-Zerlegung
  • shadow_recall — Sitzungsübergreifender Speicher-Abruf, abgestimmt auf Persona + Szenario
  • shadow_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:

  1. lib/audit-guardrail.js — 12-Muster-Regex-Ausgangstor (Schema-Ebenen-Sicherheit)
  2. lib/run-loan-council.js — if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... } (Determinismus-Schwelle)
  3. installer/tools.json — eingefrorener Installationsziel × Bereichskatalog (EMA-bereit)

Testoberfläche:

  • test/mcptox-canary.test.js — 28 Vertragstests zu MCPTox §3 Angriffskategorien + MosaicLeaks-Abdeckung
  • test/oauth-scaffold.test.js + test/oauth-loan-council-wiring.test.js — Enterprise Managed Auth Bereichskatalog + Live-Verdrahtung
  • test/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=1 erzwingt den shadow:council-Bereich auf /api/loan-council; funktioniert mit OAuth2 / Azure AD-Anspruchsformen

Links

Verwandte Skills