@vulcan-energy/mcp-helper 0.1.1

package/dist/src/tools/viewParameter.js

@@ -0,0 +1,51 @@
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * View a specific parameter JSON snippet and its markdown documentation
+ */
+export async function viewParameter(config, args) {
+    const { workspace } = config;
+    const { category, parameter_id } = args;
+    if (!category) {
+        throw new Error('category is required');
+    }
+    if (!parameter_id) {
+        throw new Error('parameter_id is required');
+    }
+    const paramDir = path.join(workspace, 'input', 'batch_parameters', category);
+    const jsonPath = path.join(paramDir, `${parameter_id}.json`);
+    const markdownPath = path.join(paramDir, `${parameter_id}.md`);
+    // Read JSON file
+    let jsonContent;
+    try {
+        const content = await fs.readFile(jsonPath, 'utf-8');
+        jsonContent = JSON.parse(content);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            throw new Error(`Parameter '${parameter_id}' not found in category '${category}'`);
+        }
+        throw new Error(`Failed to read parameter JSON: ${err.message}`);
+    }
+    // Read markdown file (optional)
+    let markdownContent = null;
+    try {
+        markdownContent = await fs.readFile(markdownPath, 'utf-8');
+    }
+    catch (error) {
+        // Markdown is optional, so we don't throw if it doesn't exist
+        const err = error;
+        if (err.code !== 'ENOENT') {
+            console.warn(`Failed to read markdown file: ${err.message}`);
+        }
+    }
+    return {
+        category,
+        parameter_id,
+        json: jsonContent,
+        markdown: markdownContent,
+        has_markdown: markdownContent !== null
+    };
+}
+//# sourceMappingURL=viewParameter.js.map

package/dist/src/tools/viewParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewParameter.js","sourceRoot":"","sources":["../../../src/tools/viewParameter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAgBxB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiB,EACjB,IAAuB;IAEvB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC7B,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAExC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,YAAY,OAAO,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC;IAE/D,iBAAiB;IACjB,IAAI,WAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAA8B,CAAC;QAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,cAAc,YAAY,4BAA4B,QAAQ,GAAG,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,gCAAgC;IAChC,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8DAA8D;QAC9D,MAAM,GAAG,GAAG,KAA8B,CAAC;QAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,iCAAiC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,eAAe;QACzB,YAAY,EAAE,eAAe,KAAK,IAAI;KACvC,CAAC;AACJ,CAAC"}

package/dist/src/utils/batchConfig.d.ts

@@ -0,0 +1,32 @@
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+interface MissingFile {
+    scenario: string;
+    category: string;
+    parameter: string;
+    path: string;
+}
+interface FileValidationResult {
+    valid: boolean;
+    errors: string[];
+    missingFiles: MissingFile[];
+}
+/**
+ * Validate batch config structure
+ * Returns { valid: boolean, errors: string[], warnings: string[] }
+ */
+export declare function validateBatchConfigStructure(config: any): ValidationResult;
+/**
+ * Calculate total permutations for a batch config
+ * Returns number or null if calculation fails
+ */
+export declare function calculatePermutations(config: any): number | null;
+/**
+ * Validate that all parameter files exist in workspace
+ */
+export declare function validateParameterFilesExist(workspace: string, config: any): Promise<FileValidationResult>;
+export {};
+//# sourceMappingURL=batchConfig.d.ts.map

package/dist/src/utils/batchConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchConfig.d.ts","sourceRoot":"","sources":["../../../src/utils/batchConfig.ts"],"names":[],"mappings":"AAGA,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,GAAG,GAAG,gBAAgB,CA6D1E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAwBhE;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkD/G"}

package/dist/src/utils/batchConfig.js

@@ -0,0 +1,130 @@
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Validate batch config structure
+ * Returns { valid: boolean, errors: string[], warnings: string[] }
+ */
+export function validateBatchConfigStructure(config) {
+    const errors = [];
+    const warnings = [];
+    if (!config || typeof config !== 'object') {
+        return { valid: false, errors: ['Config must be an object'], warnings: [] };
+    }
+    const scenarios = Object.keys(config);
+    if (scenarios.length === 0) {
+        errors.push('Config must have at least one scenario');
+    }
+    for (const [scenarioName, scenarioValue] of Object.entries(config)) {
+        if (!scenarioValue || typeof scenarioValue !== 'object') {
+            errors.push(`Scenario '${scenarioName}' must be an object`);
+            continue;
+        }
+        const scenario = scenarioValue;
+        // Check required fields
+        if (!scenario.base_json || !Array.isArray(scenario.base_json)) {
+            errors.push(`Scenario '${scenarioName}' is missing required 'base_json' field (must be array)`);
+        }
+        else if (scenario.base_json.length !== 1) {
+            errors.push(`Scenario '${scenarioName}' must have exactly one base_json (found ${scenario.base_json.length})`);
+        }
+        // Check weather_file (required)
+        if (!scenario.weather_file && !scenario.weather_files) {
+            errors.push(`Scenario '${scenarioName}' is missing required 'weather_file' or 'weather_files' field`);
+        }
+        else {
+            const weatherField = scenario.weather_file || scenario.weather_files;
+            if (!Array.isArray(weatherField) || weatherField.length !== 1) {
+                errors.push(`Scenario '${scenarioName}' must have exactly one weather_file (found ${weatherField?.length || 0})`);
+            }
+        }
+        // Check for invalid categories
+        const validCategories = [
+            'base_json', 'weather_file', 'weather_files',
+            'model_wrappers', 'simplified_fabric', 'heat_source_wet',
+            'hot_water_source', 'space_heat_emitters', 'controls',
+            'events', 'internal_gains', 'lighting', 'glazing',
+            'orientation', 'location', 'airtightness', 'mechanical_ventilation_unit',
+            'solar_systems', 'battery_systems', 'space_cooling_systems',
+            'tariff', 'compliance_settings'
+        ];
+        for (const [category, values] of Object.entries(scenario)) {
+            if (!Array.isArray(values)) {
+                errors.push(`Scenario '${scenarioName}': '${category}' must be an array`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Calculate total permutations for a batch config
+ * Returns number or null if calculation fails
+ */
+export function calculatePermutations(config) {
+    try {
+        let totalPermutations = 0;
+        for (const scenarioValue of Object.values(config)) {
+            if (!scenarioValue || typeof scenarioValue !== 'object') {
+                continue;
+            }
+            const scenario = scenarioValue;
+            let scenarioPermutations = 1;
+            for (const [category, values] of Object.entries(scenario)) {
+                if (Array.isArray(values)) {
+                    scenarioPermutations *= values.length;
+                }
+            }
+            totalPermutations += scenarioPermutations;
+        }
+        return totalPermutations;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Validate that all parameter files exist in workspace
+ */
+export async function validateParameterFilesExist(workspace, config) {
+    const errors = [];
+    const missingFiles = [];
+    for (const [scenarioName, scenarioValue] of Object.entries(config)) {
+        if (!scenarioValue || typeof scenarioValue !== 'object') {
+            continue;
+        }
+        const scenario = scenarioValue;
+        for (const [category, values] of Object.entries(scenario)) {
+            if (!Array.isArray(values)) {
+                continue;
+            }
+            // Skip weather_files - they're in a different location
+            if (category === 'weather_file' || category === 'weather_files') {
+                continue;
+            }
+            for (const paramId of values) {
+                const paramPath = path.join(workspace, 'input', 'batch_parameters', category, `${paramId}.json`);
+                try {
+                    await fs.access(paramPath);
+                }
+                catch {
+                    missingFiles.push({
+                        scenario: scenarioName,
+                        category,
+                        parameter: paramId,
+                        path: paramPath
+                    });
+                    errors.push(`Scenario '${scenarioName}': Parameter '${paramId}' in category '${category}' not found at ${paramPath}`);
+                }
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        missingFiles
+    };
+}
+//# sourceMappingURL=batchConfig.js.map

package/dist/src/utils/batchConfig.js.map

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

package/dist/src/utils/fileLoader.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Load input.schema.json from workspace
+ */
+export declare function loadSchema(workspace: string): Promise<any>;
+/**
+ * Load baseline model (demo_hp_annual.json)
+ */
+export declare function loadBaseline(workspace: string): Promise<any>;
+/**
+ * Load simplified fabric compliance example (if category is simplified_fabric)
+ */
+export declare function loadSimplifiedExample(workspace: string, category: string): Promise<any | null>;
+/**
+ * Check if a file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Ensure directory exists
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+//# sourceMappingURL=fileLoader.d.ts.map

package/dist/src/utils/fileLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileLoader.d.ts","sourceRoot":"","sources":["../../../src/utils/fileLoader.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAkBhE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAUlE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAsBpG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9D"}

package/dist/src/utils/fileLoader.js

@@ -0,0 +1,86 @@
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Load input.schema.json from workspace
+ */
+export async function loadSchema(workspace) {
+    const schemaPaths = [
+        path.join(workspace, 'input.schema.json'),
+        path.join(workspace, 'hem_engine', 'schemas', 'input.schema.json'),
+        path.join(workspace, 'input', 'hem_engine', 'schemas', 'input.schema.json'),
+    ];
+    for (const schemaPath of schemaPaths) {
+        try {
+            const content = await fs.readFile(schemaPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            // Try next path
+            continue;
+        }
+    }
+    throw new Error(`Schema file not found. Tried: ${schemaPaths.join(', ')}`);
+}
+/**
+ * Load baseline model (demo_hp_annual.json)
+ */
+export async function loadBaseline(workspace) {
+    const baselinePath = path.join(workspace, 'input', 'batch_parameters', 'base_json', 'demo_hp_annual.json');
+    try {
+        const content = await fs.readFile(baselinePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Baseline model not found at ${baselinePath}: ${err.message}`);
+    }
+}
+/**
+ * Load simplified fabric compliance example (if category is simplified_fabric)
+ */
+export async function loadSimplifiedExample(workspace, category) {
+    if (category !== 'simplified_fabric') {
+        return null;
+    }
+    const examplePaths = [
+        path.join(workspace, 'input', 'batch_parameters', 'simplified_fabric', 'good_insulation_compliance.json'),
+        path.join(workspace, 'input', 'batch_parameters', 'simplified_fabric', 'compliance_example.json'),
+    ];
+    for (const examplePath of examplePaths) {
+        try {
+            const content = await fs.readFile(examplePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            // Try next path
+            continue;
+        }
+    }
+    // Not found - return null (optional)
+    return null;
+}
+/**
+ * Check if a file exists
+ */
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensure directory exists
+ */
+export async function ensureDir(dirPath) {
+    try {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to create directory ${dirPath}: ${err.message}`);
+    }
+}
+//# sourceMappingURL=fileLoader.js.map

package/dist/src/utils/fileLoader.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@vulcan-energy/mcp-helper",
+  "version": "0.1.1",
+  "description": "Vulcan MCP Helper Service for Cursor, Claude Desktop, and other local MCP clients",
+  "type": "module",
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "bin": {
+    "vulcan-mcp-helper": "./dist/bin/vulcan-mcp-helper.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch bin/vulcan-mcp-helper.ts",
+    "start": "node dist/bin/vulcan-mcp-helper.js",
+    "prepublishOnly": "npm run build && npm run clean",
+    "clean": "echo 'Package is ready for publishing'"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "vulcan",
+    "hem",
+    "energy-modeling"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "express": "^4.18.2",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "wasm/",
+    "package.json",
+    "README.md"
+  ]
+}

package/wasm/snippets/wasm-bindgen-rayon-38edf6e439f6d70d/src/workerHelpers.no-bundler.js

@@ -0,0 +1,77 @@
+/*
+ * Copyright 2022 Google Inc. All Rights Reserved.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// This file is kept similar to workerHelpers.js, but intended to be used in
+// a bundlerless ES module environment (which has a few differences).
+
+function waitForMsgType(target, type) {
+  return new Promise(resolve => {
+    target.addEventListener('message', function onMsg({ data }) {
+      if (data == null || data.type !== type) return;
+      target.removeEventListener('message', onMsg);
+      resolve(data);
+    });
+  });
+}
+
+// We need to wait for a specific message because this file is used both
+// as a Worker and as a regular script, so it might receive unrelated
+// messages on the page.
+waitForMsgType(self, 'wasm_bindgen_worker_init').then(async data => {
+  const pkg = await import(data.mainJS);
+  await pkg.default(data.module, data.memory);
+  postMessage({ type: 'wasm_bindgen_worker_ready' });
+  pkg.wbg_rayon_start_worker(data.receiver);
+});
+
+// Note: this is never used, but necessary to prevent a bug in Firefox
+// (https://bugzilla.mozilla.org/show_bug.cgi?id=1702191) where it collects
+// Web Workers that have a shared WebAssembly memory with the main thread,
+// but are not explicitly rooted via a `Worker` instance.
+//
+// By storing them in a variable, we can keep `Worker` objects around and
+// prevent them from getting GC-d.
+let _workers;
+
+export async function startWorkers(module, memory, builder) {
+  if (builder.numThreads() === 0) {
+    throw new Error(`num_threads must be > 0.`);
+  }
+
+  const workerInit = {
+    type: 'wasm_bindgen_worker_init',
+    module,
+    memory,
+    receiver: builder.receiver(),
+    mainJS: builder.mainJS()
+  };
+
+  _workers = await Promise.all(
+    Array.from({ length: builder.numThreads() }, async () => {
+      // Self-spawn into a new Worker.
+      // The script is fetched as a blob so it works even if this script is
+      // hosted remotely (e.g. on a CDN). This avoids a cross-origin
+      // security error.
+      let scriptBlob = await fetch(import.meta.url).then(r => r.blob());
+      let url = URL.createObjectURL(scriptBlob);
+      const worker = new Worker(url, {
+        type: 'module'
+      });
+      worker.postMessage(workerInit);
+      await waitForMsgType(worker, 'wasm_bindgen_worker_ready');
+      URL.revokeObjectURL(url);
+      return worker;
+    })
+  );
+  builder.build();
+}

package/wasm/wasm_version.json

@@ -0,0 +1,8 @@
+{
+  "build_id": "20251125-090723",
+  "sha256": "20b9ffb958cb95391c32784cae48e8cf05b104d308a178be072120c2148f2bc5",
+  "timestamp": "2025-11-25T09:07:23+00:00",
+  "size_bytes": 9032697,
+  "wasm_filename": "wasm_wrapper_bg.wasm",
+  "js_filename": "wasm_wrapper.js"
+}