¿Qué hace shadow-mentor?
Consejo de cumplimiento de IA de 5 voces para préstamos regulados. Integrable en Claude Desktop / Cursor / Zed / OpenCode / OpenClaw a través de MCP. Propuesta para banco mediano estadounidense: $1,800 / asiento de oficial de cumplimiento / año. Código abierto MIT.
Qué hace
Seis herramientas MCP que convierten un chat LLM en una superficie de cumplimiento para originación de préstamos defendible ante adquisiciones:
shadow_loan_council: Veredicto determinista de 5 voces (bloquear / escalar / aprobar) + justificación por voz + paquete de riesgo + umbrales aplicados. FICO < 700 es unifcodificado con una prueba fija.shadow_risk_tools: Primitivas de riesgo institucional: VaR (histórico / paramétrico / MC), Déficit Esperado, concentración (HHI / Gini), exposición sectorial, correlación (Pearson / Spearman / EWMA), exposiciones a factores, descomposición betashadow_recall: Recuperación de memoria entre sesiones clave por persona + escenarioshadow_calibration: Estadísticas de calibración Brier por persona (para monitoreo de riesgo de modelo SR 26-2)shadow_scenarios: Enumeración de superficie (5 personas × 4 escenarios × 4 clientes de dispositivo × 2 proveedores)shadow_traceability: Atribución de fuente para cualquier umbral (BRD vs Addendum vs Nota de Apetición de Riesgo) según CFPB / ECOA / SR 26-2
Todas las herramientas se ejecutan en proceso. Sin llamadas de red desde el cuerpo de la herramienta. Los códigos de acción adversa AA01–AA05 coinciden con el Boletín 2024-09 de la CFPB.
Por qué el equipo de adquisiciones de un banco puede revisarlo en 10 minutos
Tres archivos fuente + cuatro archivos de prueba:
lib/audit-guardrail.js: Puerta de salida de expresiones regulares de 12 patrones (Seguridad de Capa de Esquema)lib/run-loan-council.js:if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... }(Piso de Determinismo)installer/tools.json: Catálogo de destino de instalación × alcance fijo (listo para EMA)
Superficie de prueba:
test/mcptox-canary.test.js: 28 pruebas de contrato que cubren categorías de ataque MCPTox §3 + cobertura MosaicLeakstest/oauth-scaffold.test.js+test/oauth-loan-council-wiring.test.js: Catálogo de alcance de Autenticación Empresarial Gestionada + cableado en vivotest/glm-call.test.js: Contrato multiproveedor (Anthropic + GLM-5.2)test/tools-catalog.test.js: Puerta de deriva del catálogo
308/308 pruebas aprobadas. Puntuación Shadow Agentic 87 ± 3 (n=6).
Instalación rápida
git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs # ver qué hosts MCP se detectan
node bin/install.mjs --host cursor --dry-run # previsualizar la configuración fusionada
node bin/install.mjs --host cursor # escribirla
Defiende contra amenazas MCP nombradas de 2026
- Aviso de cadena de suministro STDIO MCP de OX Security (mayo 2026) — Los cuerpos de las herramientas de Shadow solo llaman a módulos
lib/congelados; ninguna entrada de shell no confiable llega al cuerpo de una herramienta - Benchmark MCPTox (arXiv 2508.14925) — Shadow devuelve veredictos de enumeración JSON estrictos, no narrativos; las descripciones envenenadas no pueden ampliar la superficie de respuesta más allá del esquema
- Fuga de información multironda MosaicLeaks — las pruebas de contrato de token canario fijan la invariante de que un atacante no puede exfiltrar un canario a través del límite de la herramienta
- OAuth empresarial MCP (EMA) —
SHADOW_REQUIRE_BEARER=1opcional aplica el alcanceshadow:councilen/api/loan-council; funciona con formas de reclamo OAuth2 / Azure AD
Enlaces
- Repositorio: https://github.com/alex-jb/shadow-mentor
- Versión: https://github.com/alex-jb/shadow-mentor/releases/tag/v1.2.0
- Comparación con Anthropic FS Agents:
docs/positioning-vs-anthropic-fs.md - Principios:
docs/principles/schema-layer-safety.md·docs/principles/determinism-floor.md - Licencia: MIT