@csgaglobal/explainability-engine 1.0.0

package/LICENSE

@@ -0,0 +1,8 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+INFORMATION ON AN "AS-IS" BASIS.

package/README.md

@@ -0,0 +1,48 @@
+# @csgaglobal/explainability-engine
+
+AI decision explainability and interpretability tools. Provides SHAP, LIME, counterfactual explanations, and stakeholder-appropriate explanation generation.
+
+## Installation
+
+```bash
+npx @csgaglobal/explainability-engine
+```
+
+## MCP Configuration
+
+```json
+{
+  "mcpServers": {
+    "explainability-engine": {
+      "command": "npx",
+      "args": ["-y", "@csgaglobal/explainability-engine"]
+    }
+  }
+}
+```
+
+## Tool: explainability_manage
+
+Manage AI explainability and interpretability
+
+### Parameters
+
+- **system_name**: AI system to explain
+- **operation**: Operation (explain-decision, feature-importance, counterfactual, model-global, generate-report)
+- **explanation_audience**: Audience (technical, business, affected-individual, regulator, auditor)
+- **explanation_method**: Method (SHAP, LIME, counterfactual, attention, rule-extraction)
+- **jurisdiction**: Operating jurisdiction or region
+
+## Category
+
+- **Category:** DevOps
+- **CA3O Level:** DevOps
+
+## License
+
+CC0-1.0 — Creative Commons Zero v1.0 Universal
+
+## Author
+
+CSGA Global — Cyber Security Global Alliance
+https://csga-global.vercel.app/

package/dist/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * @csgaglobal/explainability-engine
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Copyright (c) 2026 CSGA Global. All rights reserved.
+ * Part of the CSGA Global MCP Ecosystem.
+ *
+ * LEGAL NOTICE: This software is provided for informational and advisory
+ * purposes only. It does not constitute legal, regulatory, or professional
+ * compliance advice. Users should consult qualified legal counsel for
+ * jurisdiction-specific compliance requirements.
+ *
+ * License: CC0-1.0 (Creative Commons Zero v1.0 Universal)
+ * SPDX-License-Identifier: CC0-1.0
+ *
+ * Build Timestamp: 2026-03-02T10:00:00Z
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { handleExplainabilityEngineCompliance } from "./tools/explainability-engine-compliance.js";
+const server = new McpServer({
+    name: "csoai-explainability-engine-mcp",
+    version: "1.0.0"
+});
+const ComplianceShape = {
+    system_name: z.string().describe("AI system to explain"),
+    operation: z.string().describe("Operation (explain-decision, feature-importance, counterfactual, model-global, generate-report)"),
+    explanation_audience: z.string().describe("Audience (technical, business, affected-individual, regulator, auditor)"),
+    explanation_method: z.string().describe("Method (SHAP, LIME, counterfactual, attention, rule-extraction)"),
+    jurisdiction: z.string().describe("Operating jurisdiction or region")
+};
+server.tool("explainability_manage", "Manage AI explainability and interpretability", ComplianceShape, async (args) => {
+    const result = handleExplainabilityEngineCompliance(args.system_name, args.operation, args.explanation_audience, args.explanation_method, args.jurisdiction);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/dist/tools/explainability-engine-compliance.js

@@ -0,0 +1,86 @@
+/**
+ * explainability-engine-compliance.js — Part of @csgaglobal MCP Ecosystem
+ * Copyright (c) 2026 CSGA Global. All rights reserved.
+ * License: CC0-1.0 | Build: 2026-03-02T10:00:00Z
+ * LEGAL NOTICE: Advisory only. Not legal or compliance advice.
+ */
+export function handleExplainabilityEngineCompliance(system_name, operation, explanation_audience, explanation_method, jurisdiction) {
+    const jurLower = jurisdiction.toLowerCase();
+    const fnLower = operation.toLowerCase();
+    let riskClassification = "Standard explainability engine AI use";
+    let riskLevel = "MEDIUM";
+    if (fnLower.includes("autonomous") || fnLower.includes("automated") || fnLower.includes("decision")) {
+        riskClassification = "HIGH RISK — Autonomous/automated decision-making requires enhanced oversight";
+        riskLevel = "HIGH";
+    }
+    if (fnLower.includes("surveillance") || fnLower.includes("biometric") || fnLower.includes("facial")) {
+        riskClassification = "CRITICAL RISK — Biometric/surveillance AI triggers strictest regulatory requirements";
+        riskLevel = "CRITICAL";
+    }
+    const regulations = [];
+    if (jurLower.includes("eu") || jurLower.includes("europe")) {
+        regulations.push("EU AI Act Art. 13 — Transparency for high-risk AI");
+        regulations.push("GDPR Art. 22 — Right to explanation");
+        regulations.push("EU AI Act Art. 86 — Right to explanation of AI decisions");
+    }
+    if (jurLower.includes("us") || jurLower.includes("united states")) {
+        regulations.push("ECOA — Adverse action notice requirements");
+        regulations.push("FCRA — Reason code requirements for AI decisions");
+        regulations.push("FTC — AI transparency expectations");
+    }
+    if (jurLower.includes("uk")) {
+        regulations.push("ICO — AI explainability guidance");
+        regulations.push("UK AI White Paper — Transparency principle");
+        regulations.push("FCA — AI model explainability for financial services");
+    }
+    if (regulations.length === 0) {
+        regulations.push("General consumer protection and data privacy laws apply");
+        regulations.push("Industry-specific regulations for explainability engine");
+    }
+    const compliance = [
+        "Implement multi-method explainability framework",
+        "Deploy stakeholder-appropriate explanation generation",
+        "Establish right-to-explanation compliance workflow",
+        "Create explanation quality metrics and monitoring",
+        "Generate regulatory explainability documentation",
+    ];
+    if (riskLevel === "CRITICAL" || riskLevel === "HIGH") {
+        compliance.push("EU AI Act conformity assessment required for high-risk classification");
+        compliance.push("Data Protection Impact Assessment (DPIA) mandatory");
+        compliance.push("Appoint AI governance officer or responsible person");
+    }
+    const technical = [
+        "Multi-method XAI engine (SHAP, LIME, counterfactual)",
+        "Stakeholder explanation generator",
+        "Right-to-explanation workflow",
+        "Explanation quality monitoring",
+        "Regulatory explainability documentation",
+    ];
+    const remediation = [];
+    if (riskLevel === "CRITICAL") {
+        remediation.push("URGENT: Conduct comprehensive regulatory review before deployment");
+        remediation.push("Commission independent third-party AI safety audit");
+        remediation.push("Implement mandatory human-in-the-loop for all critical decisions");
+    } else if (riskLevel === "HIGH") {
+        remediation.push("Conduct DPIA and update data processing agreements");
+        remediation.push("Implement enhanced monitoring and alerting for AI decisions");
+        remediation.push("Establish regular (quarterly) compliance review cycle");
+    }
+    remediation.push("Maintain comprehensive AI system documentation per EU AI Act Art. 11");
+    remediation.push("Establish stakeholder engagement process for affected communities");
+    remediation.push("Monitor evolving regulatory requirements in operating jurisdictions");
+    let casaTier = "CASA Tier 1 — Startup ($5K-$25K/yr)";
+    if (riskLevel === "CRITICAL") casaTier = "CASA Tier 3 — Enterprise ($75K-$200K/yr)";
+    else if (riskLevel === "HIGH") casaTier = "CASA Tier 2 — Professional ($25K-$75K/yr)";
+    else if (riskLevel === "MEDIUM") casaTier = "CASA Tier 2 — Professional ($25K-$75K/yr)";
+    return {
+        system_name: system_name,
+        risk_classification: riskClassification,
+        risk_level: riskLevel,
+        applicable_regulations: regulations,
+        compliance_requirements: compliance,
+        technical_requirements: technical,
+        remediation,
+        casa_tier: casaTier
+    };
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@csgaglobal/explainability-engine",
+  "version": "1.0.0",
+  "description": "AI decision explainability and interpretability tools. Provides SHAP, LIME, counterfactual explanations, and stakeholder-appropriate explanation generation.",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "explainability-engine-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "@types/node": "^22.12.0"
+  },
+  "license": "CC0-1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/csga-global/mcp-servers.git",
+    "directory": "packages/explainability-engine"
+  },
+  "author": "CSGA Global \u2014 Cyber Security Global Alliance",
+  "keywords": [
+    "mcp",
+    "ai-governance",
+    "compliance",
+    "csoai",
+    "explainability",
+    "interpretability",
+    "shap",
+    "lime",
+    "counterfactual",
+    "xai"
+  ]
+}