CommunityRédaction et éditiongithub.com

shadow-mentor

Shadow — conseil IA sur appareil et chaîne d'audit pour les processus bancaires réglementés. Un moteur, 4 clients appareils, 5 packs de personnalités.

Qu'est-ce que shadow-mentor ?

Shadow Mentor est un moteur de conseil en conformité IA à cinq voix, conçu pour les flux de travail bancaires réglementés, en particulier l'origination de prêts. Déployé via MCP (Model Context Protocol) dans des outils comme Claude Desktop, Cursor, Zed, OpenCode et OpenClaw, il transforme une conversation LLM en une surface de conformité solide et défendable par les achats. Le système offre six outils MCP, dont un conseil de prêt déterministe qui applique des seuils durs (par exemple, FICO < 700 = blocage), des primitives de risque institutionnel (VaR, Expected Shortfall, concentration), la mémorisation inter-sessions, l'étalonnage Brier pour la surveillance des modèles, l'énumération des surfaces d'attaque et la traçabilité des sources. Tous les outils fonctionnent en mémoire sans appels réseau, ce qui garantit la conformité avec la réglementation CFPB, ECOA et SR 26-2. Avec 308 tests réussis, un score agentique de 87 ± 3 et une défense documentée contre les menaces MCP 2026 (MCPTox, MosaicLeaks, OAuth Enterprise), c'est une solution prête pour l'audit bancaire de niveau intermédiaire, proposée à 1 800 $ par siège d'agent de conformité par an.

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait shadow-mentor ?

Conseil de conformité IA à 5 voix pour les prêts réglementés. Intégration dans Claude Desktop / Cursor / Zed / OpenCode / OpenClaw via MCP. Pitch pour une banque américaine de taille intermédiaire : 1 800 $ / siège d'agent de conformité / an. Open source sous licence MIT.

Ce qu'il fait

Six outils MCP qui transforment une conversation LLM en une surface de conformité défendable pour l'origination de prêts :

  • shadow_loan_council — Verdict déterministe à 5 voix (bloquer / escalader / approuver) + justification par voix + paquet de risque + seuils appliqués. FICO < 700 est un if codé en dur avec un test fixe.
  • shadow_risk_tools — Primitives de risque institutionnel : VaR (historique / paramétrique / Monte Carlo), Expected Shortfall, concentration (HHI / Gini), exposition sectorielle, corrélation (Pearson / Spearman / EWMA), expositions factorielles, décomposition bêta
  • shadow_recall — Rappel de mémoire inter-sessions indexé par personnalité + scénario
  • shadow_calibration — Statistiques d'étalonnage Brier par personnalité (pour la surveillance des risques de modèle SR 26-2)
  • shadow_scenarios — Énumération de surface (5 personnalités × 4 scénarios × 4 clients appareils × 2 fournisseurs)
  • shadow_traceability — Attribution de source pour tout seuil (BRD vs Addendum vs Note d'appétit au risque) conforme à la CFPB / ECOA / SR 26-2

Tous les outils fonctionnent en mémoire. Aucun appel réseau depuis le corps de l'outil. Les codes d'action défavorable AA01–AA05 correspondent au Bulletin CFPB 2024-09.

Pourquoi l'équipe achats d'une banque peut le valider en 10 minutes

Trois fichiers source + quatre fichiers de test :

  1. lib/audit-guardrail.js — Porte de sortie regex à 12 motifs (sécurité au niveau du schéma)
  2. lib/run-loan-council.js — if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... } (Base de déterminisme)
  3. installer/tools.json — Catalogue gelé cible × périmètre (prêt pour EMA)

Surface de test :

  • test/mcptox-canary.test.js — 28 tests contractuels couvrant les catégories d'attaque MCPTox §3 + couverture MosaicLeaks
  • test/oauth-scaffold.test.js + test/oauth-loan-council-wiring.test.js — Catalogue de périmètre OAuth Enterprise géré + câblage en direct
  • test/glm-call.test.js — Contrat multi-fournisseur (Anthropic + GLM-5.2)
  • test/tools-catalog.test.js — Porte de dérive du catalogue

308/308 tests réussis. Score Agentique Shadow 87 ± 3 (n=6).

Installation rapide

git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs                          # voir quels hôtes MCP sont détectés
node bin/install.mjs --host cursor --dry-run  # prévisualiser la configuration fusionnée
node bin/install.mjs --host cursor            # l'écrire

Défense contre les menaces MCP nommées de 2026

  • Avis OX Security sur la chaîne d'approvisionnement MCP STDIO (Mai 2026) — Les corps d'outils de Shadow n'appellent que des modules lib/ gelés ; aucune entrée shell non fiable n'atteint un corps d'outil
  • Benchmark MCPTox (arXiv 2508.14925) — Shadow renvoie des verdicts d'énumération JSON stricts, pas de narration ; les descriptions empoisonnées ne peuvent pas élargir la surface de réponse au-delà du schéma
  • Fuite d'informations multi-tours MosaicLeaks — Les tests contractuels de jetons canari fixent l'invariant selon lequel un attaquant ne peut pas exfiltrer un canari à travers la frontière de l'outil
  • OAuth Enterprise MCP (EMA) — SHADOW_REQUIRE_BEARER=1 en option impose le périmètre shadow:council sur /api/loan-council ; fonctionne avec les formes de revendication OAuth2 / Azure AD

Liens

Skills associés