aibvf-mcp 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# aibvf-mcp
+
+MCP server exposing AI BVF v1.0 to any Claude agent. Pre-flight-check your AI initiatives before you deploy them.
+
+## Install and run
+
+```bash
+npx aibvf-mcp
+```
+
+## Wire into Claude Desktop / Cursor / any MCP host
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "aibvf": {
+      "command": "npx",
+      "args": ["-y", "aibvf-mcp"]
+    }
+  }
+}
+```
+
+Then ask Claude:
+
+> *"Score this AI initiative using AI BVF: we're a €2.4bn manufacturer, planning a GenAI predictive maintenance rollout in our EU plants, we're a traditional hierarchy, strong sponsor, modest change budget."*
+
+Claude will call `score_initiative` and return the classification, euro range, and reasoning.
+
+## Tools exposed
+
+| Tool | Purpose |
+|---|---|
+| `score_initiative` | Return classification (Accelerate/Fix/Stop), euro range, and reasoning for one initiative. |
+| `validate_portfolio` | Check a BVF portfolio JSON against the v1.0 schema. |
+| `get_benchmark` | Return the published benchmark base-rate and industry multiplier for a function + industry. |
+| `list_taxonomy` | List the valid industries, functions, AI tiers, and readiness levels. |
+
+## Spec
+
+<https://bvf-app.vercel.app/protocol>
+
+## License
+
+MIT.

package/dist/index.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+/**
+ * aibvf-mcp — an MCP server exposing AI BVF v1.0 scoring and validation as tools
+ * callable by any Claude agent or MCP-compatible host.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { score, validate, BASE_RATES, IND_MULT, INDUSTRIES, FUNCTIONS, AI_TIERS, READINESS, BVF_VERSION, } from '@aibvf/core';
+const server = new Server({ name: 'aibvf-mcp', version: '0.1.0' }, { capabilities: { tools: {} } });
+const scoreInputSchema = {
+    type: 'object',
+    required: ['industry', 'revenue_eur', 'function', 'ai_tier', 'readiness', 'scores'],
+    properties: {
+        industry: { type: 'string', enum: INDUSTRIES, description: 'Your industry. See list_taxonomy if unsure.' },
+        revenue_eur: { type: 'number', minimum: 0, description: 'Approximate annual revenue in EUR.' },
+        function: { type: 'string', enum: FUNCTIONS, description: 'Business function where the AI will operate.' },
+        ai_tier: { type: 'string', enum: AI_TIERS, description: 'gen1=automation/RPA, gen2=GenAI, gen3=agentic.' },
+        readiness: { type: 'string', enum: READINESS, description: 'Organisational readiness. Honest self-assessment.' },
+        scores: {
+            type: 'object',
+            required: ['strategic_alignment', 'financial_return', 'change_enablement', 'governance_risk'],
+            properties: {
+                strategic_alignment: { type: 'number', minimum: 0, maximum: 100, description: 'How clearly this moves a board-level KPI (0-100).' },
+                financial_return: { type: 'number', minimum: 0, maximum: 100, description: 'Strength of modelled return (0-100).' },
+                change_enablement: { type: 'number', minimum: 0, maximum: 100, description: 'Sponsor, owner, funded change budget (0-100).' },
+                governance_risk: { type: 'number', minimum: 0, maximum: 100, description: 'Regulatory / reputational exposure. Higher = more risk (0-100).' },
+            },
+        },
+    },
+};
+const TOOLS = [
+    {
+        name: 'score_initiative',
+        description: 'Score a single AI initiative using AI BVF v1.0. Returns classification (Accelerate / Fix / Stop), modelled EUR value range, decision confidence, and reasoning. Use this as a pre-flight check before recommending any AI deployment.',
+        inputSchema: scoreInputSchema,
+    },
+    {
+        name: 'validate_portfolio',
+        description: 'Validate a portfolio JSON document against the AI BVF v1.0 schema. Returns valid=true or a list of errors with JSON paths.',
+        inputSchema: {
+            type: 'object',
+            required: ['portfolio'],
+            properties: { portfolio: { type: 'object', description: 'The portfolio JSON document to validate.' } },
+        },
+    },
+    {
+        name: 'get_benchmark',
+        description: 'Look up the published benchmark rates for a business function and industry. Returns revenue/cost ranges, industry multiplier, and the cited source.',
+        inputSchema: {
+            type: 'object',
+            required: ['function', 'industry'],
+            properties: {
+                function: { type: 'string', enum: FUNCTIONS },
+                industry: { type: 'string', enum: INDUSTRIES },
+            },
+        },
+    },
+    {
+        name: 'list_taxonomy',
+        description: 'Return the valid values for all AI BVF enums: industries, functions, AI tiers, and readiness levels.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    try {
+        if (name === 'score_initiative') {
+            const r = score(args);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            bvf_version: BVF_VERSION,
+                            classification: r.classification,
+                            reason: r.reason,
+                            net_value_eur: { low: r.net_low_eur, high: r.net_high_eur },
+                            gross_value_eur: { low: r.gross_low_eur, high: r.gross_high_eur },
+                            decision_confidence: r.confidence,
+                            multipliers: r.multipliers,
+                            drivers: r.drivers,
+                            benchmark_source: r.source,
+                        }, null, 2),
+                    }],
+            };
+        }
+        if (name === 'validate_portfolio') {
+            const result = validate(args.portfolio);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ bvf_version: BVF_VERSION, ...result }, null, 2),
+                    }],
+            };
+        }
+        if (name === 'get_benchmark') {
+            const { function: fn, industry } = args;
+            const base = BASE_RATES[fn];
+            const mult = (IND_MULT[industry] ?? IND_MULT.universal)[fn];
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            function: fn,
+                            industry,
+                            revenue_uplift_range: base.rev,
+                            cost_takeout_range: base.cost,
+                            industry_multiplier: mult,
+                            drivers: base.drivers,
+                            source: base.source,
+                        }, null, 2),
+                    }],
+            };
+        }
+        if (name === 'list_taxonomy') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            bvf_version: BVF_VERSION,
+                            industries: INDUSTRIES,
+                            functions: FUNCTIONS,
+                            ai_tiers: AI_TIERS,
+                            readiness: READINESS,
+                        }, null, 2),
+                    }],
+            };
+        }
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error('aibvf-mcp v0.1.0 ready on stdio');
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "aibvf-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing AI BVF v1.0 scoring and validation to any Claude agent.",
+  "keywords": ["mcp", "model-context-protocol", "ai-bvf", "claude", "agent", "ai-governance"],
+  "homepage": "https://bvf-app.vercel.app/protocol",
+  "repository": "github:craighorton/ai-bvf",
+  "license": "MIT",
+  "author": "Craig Horton",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "aibvf-mcp": "dist/index.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@aibvf/core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  }
+}