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 unifcodé 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êtashadow_recall— Rappel de mémoire inter-sessions indexé par personnalité + scénarioshadow_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 :
lib/audit-guardrail.js— Porte de sortie regex à 12 motifs (sécurité au niveau du schéma)lib/run-loan-council.js—if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... }(Base de déterminisme)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 MosaicLeakstest/oauth-scaffold.test.js+test/oauth-loan-council-wiring.test.js— Catalogue de périmètre OAuth Enterprise géré + câblage en directtest/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=1en option impose le périmètreshadow:councilsur/api/loan-council; fonctionne avec les formes de revendication OAuth2 / Azure AD
Liens
- Dépôt : https://github.com/alex-jb/shadow-mentor
- Version : https://github.com/alex-jb/shadow-mentor/releases/tag/v1.2.0
- Comparaison avec les agents Anthropic FS :
docs/positioning-vs-anthropic-fs.md - Principes :
docs/principles/schema-layer-safety.md·docs/principles/determinism-floor.md - Licence : MIT