shadow-mentor
Conselho de compliance de IA com 5 vozes para crédito regulado. Integre-se ao Claude Desktop / Cursor / Zed / OpenCode / OpenClaw via MCP. Proposta para bancos de médio porte: US$ 1.800 / assento de oficial de compliance / ano. Código aberto MIT.
O que faz
Seis ferramentas MCP que transformam um chat LLM em uma superfície de compliance defensável para originação de crédito:
shadow_loan_council— Veredito determinístico de 5 vozes (bloquear / escalar / aprovar) + justificativa por voz + pacote de risco + limites aplicados. FICO < 700 é umifcodificado com um teste fixo.shadow_risk_tools— Primitivas de risco institucional: VaR (histórico / paramétrico / MC), Expected Shortfall, concentração (HHI / Gini), exposição setorial, correlação (Pearson / Spearman / EWMA), exposições a fatores, decomposição betashadow_recall— Recuperação de memória entre sessões, indexada por persona + cenárioshadow_calibration— Estatísticas de calibração Brier por persona (para monitoramento de risco de modelo SR 26-2)shadow_scenarios— Enumeração de superfície (5 personas × 4 cenários × 4 clientes de dispositivo × 2 provedores)shadow_traceability— Atribuição de fonte para qualquer limite (BRD vs Adendo vs Nota de Apetite de Risco) conforme CFPB / ECOA / SR 26-2
Todas as ferramentas são executadas em processo. Nenhuma chamada de rede dentro do corpo da ferramenta. Os códigos de ação adversa AA01–AA05 correspondem ao Boletim CFPB 2024-09.
Por que a equipe de compras de um banco pode fazer grep em 10 minutos
Três arquivos de código + quatro arquivos de teste:
lib/audit-guardrail.js— Gate de saída com regex de 12 padrões (Segurança em Camada 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 instalação por alvo × escopo (pronto para EMA)
Superfície de teste:
test/mcptox-canary.test.js— 28 testes de contrato cobrindo as categorias de ataque MCPTox §3 + cobertura MosaicLeakstest/oauth-scaffold.test.js+test/oauth-loan-council-wiring.test.js— Catálogo de escopo do Enterprise Managed Auth + fiação ativatest/glm-call.test.js— Contrato multiprovedor (Anthropic + GLM-5.2)test/tools-catalog.test.js— Gate de deriva de catálogo
308/308 testes aprovados. Shadow Agentic Score 87 ± 3 (n=6).
Instalação rápida
git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs # veja quais hosts MCP são detectados
node bin/install.mjs --host cursor --dry-run # visualize a configuração mesclada
node bin/install.mjs --host cursor # escreva-a
Defende-se contra ameaças MCP nomeadas de 2026
- Advisory OX Security MCP STDIO sobre cadeia de suprimentos (Maio 2026) — Os corpos das ferramentas do Shadow chamam apenas módulos congelados de
lib/; nenhuma entrada de shell não confiável atinge o corpo de uma ferramenta - Benchmark MCPTox (arXiv 2508.14925) — Shadow retorna vereditos de enumeração JSON estritos, não narrativos; descrições envenenadas não conseguem ampliar a superfície de resposta além do esquema
- Vazamento de informações em múltiplas voltas MosaicLeaks — testes de contrato com token canário fixam o invariante de que um atacante não pode exfiltrar um canário através do limite da ferramenta
- OAuth Enterprise MCP (EMA) —
SHADOW_REQUIRE_BEARER=1opcional impõe escoposhadow:councilem/api/loan-council; funciona com formatos de declaração OAuth2 / Azure AD
Links
- Repositório: https://github.com/alex-jb/shadow-mentor
- Release: https://github.com/alex-jb/shadow-mentor/releases/tag/v1.2.0
- Comparação com Anthropic FS Agents:
docs/positioning-vs-anthropic-fs.md - Princípios:
docs/principles/schema-layer-safety.md·docs/principles/determinism-floor.md - Licença: MIT