shadow-mentor は何をしますか?
規制対象融資のための5人格AIコンプライアンス評議会。Claude Desktop / Cursor / Zed / OpenCode / OpenClaw にMCP経由で導入。中堅米銀向け提案: 年間1席あたり1,800ドル(コンプライアンス責任者席)。オープンソース MIT。
機能
6つのMCPツールがLLMチャットを調達監査可能な融資実行・コンプライアンスサーフェスに変換します:
shadow_loan_council— 5人格による決定論的評決(ブロック / エスカレーション / 承認)+ 人格ごとの根拠 + リスクパケット + 適用された閾値。FICO < 700 はハードコードされたifと固定テストあり。shadow_risk_tools— 機関リスクの基本要素: VaR(履歴 / パラメトリック / モンテカルロ)、期待ショートフォール、集中度(HHI / ジニ)、セクターエクスポージャー、相関(ピアソン / スピアマン / EWMA)、ファクターエクスポージャー、ベータ分解shadow_recall— ペルソナ+シナリオをキーとしたセッション間メモリ呼び出しshadow_calibration— ペルソナごとのBrierキャリブレーション統計(SR 26-2モデルリスクモニタリング用)shadow_scenarios— サーフェス列挙(5ペルソナ × 4シナリオ × 4デバイスクライアント × 2プロバイダー)shadow_traceability— 任意の閾値のソース帰属(BRD vs 補遺 vs リスクアペタイトノート)、CFPB / ECOA / SR 26-2準拠
すべてのツールはインプロセスで動作。ツール本体からネットワーク呼び出しは一切行われません。AA01~AA05の不利処分コードはCFPB Bulletin 2024-09に対応。
銀行の調達部門が10分でgrepできる理由
3つのソースファイル + 4つのテストファイル:
lib/audit-guardrail.js— 12パターンの正規表現出力ゲート(スキーマ層セーフティ)lib/run-loan-council.js—if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... }(決定論的フロア)installer/tools.json— 固定されたインストールターゲット × スコープカタログ(EMA対応)
テストサーフェス:
test/mcptox-canary.test.js— MCPTox §3攻撃カテゴリ + MosaicLeaksカバレッジを対象とする28のコントラクトテストtest/oauth-scaffold.test.js+test/oauth-loan-council-wiring.test.js— Enterprise Managed Authスコープカタログ + 実際の配線test/glm-call.test.js— マルチプロバイダーコントラクト(Anthropic + GLM-5.2)test/tools-catalog.test.js— カタログドリフトゲート
308/308テスト合格。Shadow Agentic Score 87 ± 3(n=6)。
クイックインストール
git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs # 検出されたMCPホストを確認
node bin/install.mjs --host cursor --dry-run # マージ後の設定をプレビュー
node bin/install.mjs --host cursor # 書き込み
名前付きの2026年MCP脅威に対する防御
- OX Security MCP STDIOサプライチェーン勧告(2026年5月) — Shadowのツール本体は固定された
lib/モジュールのみを呼び出し、信頼されていないシェル入力がツール本体に到達することはありません - MCPToxベンチマーク(arXiv 2508.14925) — Shadowは厳密なJSON enum評決を返し、散文形式の応答は返しません。悪意のある説明によってスキーマを超えた応答範囲が広がることはありません
- MosaicLeaksマルチターン情報漏洩 — カナリアトークンコントラクトテストが、攻撃者がツール境界を越えてカナリアを流出させられないという不変条件を固定します
- MCP Enterprise OAuth(EMA) — オプトインの
SHADOW_REQUIRE_BEARER=1により、/api/loan-councilへのアクセスにshadow:councilスコープを強制。OAuth2 / Azure ADクレームシェイプで動作
リンク
- リポジトリ: https://github.com/alex-jb/shadow-mentor
- リリース: https://github.com/alex-jb/shadow-mentor/releases/tag/v1.2.0
- Anthropic FS Agentsとの比較:
docs/positioning-vs-anthropic-fs.md - 原則:
docs/principles/schema-layer-safety.md·docs/principles/determinism-floor.md - ライセンス: MIT