CommunityRedacción y edicióngithub.com

shadow-mentor

Shadow: un consejo de IA y cadena de auditoría en el dispositivo para flujos de trabajo bancarios regulados. Un motor, 4 clientes de dispositivo, 5 paquetes de personalidad.

¿Qué es shadow-mentor?

Shadow Mentor es un motor de cumplimiento normativo que funciona como un consejo de IA de cinco voces, diseñado para flujos de trabajo de originación de préstamos regulados en bancos medianos. Proporciona seis herramientas MCP que transforman un chat LLM en una superficie de cumplimiento defendible ante adquisiciones, incluyendo un veredicto determinista de cinco voces (bloquear, escalar, aprobar), primitivas de riesgo institucional, memoria entre sesiones y atribución de fuentes. El sistema está construido para ser auditado rápidamente por equipos de adquisiciones, con solo tres archivos fuente y cuatro archivos de prueba, y una puntuación de 308/308 pruebas aprobadas. Defiende contra amenazas MCP conocidas de 2026, como la cadena de suministro STDIO de OX Security, el benchmark MCPTox y la fuga de información MosaicLeaks, y es compatible con Claude Desktop, Cursor, Zed, OpenCode y OpenClaw a través del protocolo MCP.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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 un if codificado 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 beta
  • shadow_recall: Recuperación de memoria entre sesiones clave por persona + escenario
  • shadow_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:

  1. lib/audit-guardrail.js: Puerta de salida de expresiones regulares de 12 patrones (Seguridad de Capa de Esquema)
  2. lib/run-loan-council.js: if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... } (Piso de Determinismo)
  3. 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 MosaicLeaks
  • test/oauth-scaffold.test.js + test/oauth-loan-council-wiring.test.js: Catálogo de alcance de Autenticación Empresarial Gestionada + cableado en vivo
  • test/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=1 opcional aplica el alcance shadow:council en /api/loan-council; funciona con formas de reclamo OAuth2 / Azure AD

Enlaces

Skills relacionados