@vulcan-energy/mcp-helper 0.1.1

package/dist/src/engine/wasm.js

@@ -0,0 +1,333 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { pathToFileURL } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Ensure all console.log noise goes to stderr so Cursor only receives JSON-RPC on stdout.
+ * Must run before any other module (especially WASM) calls console.log.
+ */
+let consoleRedirected = false;
+function redirectConsoleToStderr() {
+    if (consoleRedirected) {
+        return;
+    }
+    const originalConsole = globalThis.console || console;
+    if (!originalConsole) {
+        return;
+    }
+    const errorLogger = typeof originalConsole.error === 'function'
+        ? originalConsole.error.bind(originalConsole)
+        : (...args) => {
+            process.stderr.write(args.map(String).join(' ') + '\n');
+        };
+    const patchedConsole = originalConsole;
+    patchedConsole.log = (...args) => errorLogger(...args);
+    globalThis.console = patchedConsole;
+    consoleRedirected = true;
+}
+redirectConsoleToStderr();
+/**
+ * Resolve WASM paths for both rust-hem-runner and vulcan-website contexts
+ *
+ * In rust-hem-runner: web/pkg/wasm_wrapper.js
+ * In vulcan-website: apps/web/public/launch/wasm_wrapper.js
+ *
+ * Also checks for helper service's own bundled WASM (for npm distribution)
+ */
+function resolveWasmPaths() {
+    // __dirname in compiled code is dist/src/engine/
+    // We need to go up to project root: dist/src/engine -> dist/src -> dist -> project root
+    // Or use process.cwd() which should be the project root when running from bin/
+    // Try rust-hem-runner first (MCP server is in rust-hem-runner/vulcan-mcp-server/)
+    // From dist/src/engine/, go: .. -> .. -> .. -> .. -> web/dist/wasm/
+    const projectRoot = path.resolve(__dirname, '..', '..', '..', '..');
+    const rustHemRunnerDist = path.join(projectRoot, 'web', 'dist', 'wasm');
+    const rustHemRunnerJs = path.join(rustHemRunnerDist, 'wasm_wrapper.js');
+    const rustHemRunnerWasm = path.join(rustHemRunnerDist, 'wasm_wrapper_bg.wasm');
+    if (fs.existsSync(rustHemRunnerJs) && fs.existsSync(rustHemRunnerWasm)) {
+        return {
+            jsPath: rustHemRunnerJs,
+            wasmPath: rustHemRunnerWasm,
+            context: 'rust-hem-runner'
+        };
+    }
+    // Try alternative location: web/dist/wasm_wrapper.js (without wasm subdirectory)
+    const rustHemRunnerDistAlt = path.join(projectRoot, 'web', 'dist');
+    const rustHemRunnerJsAlt = path.join(rustHemRunnerDistAlt, 'wasm_wrapper.js');
+    const rustHemRunnerWasmAlt = path.join(rustHemRunnerDistAlt, 'wasm_wrapper_bg.wasm');
+    if (fs.existsSync(rustHemRunnerJsAlt) && fs.existsSync(rustHemRunnerWasmAlt)) {
+        return {
+            jsPath: rustHemRunnerJsAlt,
+            wasmPath: rustHemRunnerWasmAlt,
+            context: 'rust-hem-runner'
+        };
+    }
+    // Try web/pkg/ (original location)
+    const rustHemRunnerPkg = path.join(projectRoot, 'web', 'pkg');
+    const rustHemRunnerPkgJs = path.join(rustHemRunnerPkg, 'wasm_wrapper.js');
+    const rustHemRunnerPkgWasm = path.join(rustHemRunnerPkg, 'wasm_wrapper_bg.wasm');
+    if (fs.existsSync(rustHemRunnerPkgJs) && fs.existsSync(rustHemRunnerPkgWasm)) {
+        return {
+            jsPath: rustHemRunnerPkgJs,
+            wasmPath: rustHemRunnerPkgWasm,
+            context: 'rust-hem-runner'
+        };
+    }
+    // Try helper service's own directory inside dist/ (local dev + npm)
+    const helperDistWasmDir = path.resolve(__dirname, '..', '..', 'wasm');
+    const helperDistJs = path.join(helperDistWasmDir, 'wasm_wrapper.js');
+    const helperDistWasm = path.join(helperDistWasmDir, 'wasm_wrapper_bg.wasm');
+    if (fs.existsSync(helperDistJs) && fs.existsSync(helperDistWasm)) {
+        return {
+            jsPath: helperDistJs,
+            wasmPath: helperDistWasm,
+            context: 'helper-dist'
+        };
+    }
+    // Try helper service root (when installed from npm, wasm/ sits at package root)
+    const helperRootWasmDir = path.resolve(__dirname, '..', '..', '..', 'wasm');
+    const helperRootJs = path.join(helperRootWasmDir, 'wasm_wrapper.js');
+    const helperRootWasm = path.join(helperRootWasmDir, 'wasm_wrapper_bg.wasm');
+    if (fs.existsSync(helperRootJs) && fs.existsSync(helperRootWasm)) {
+        return {
+            jsPath: helperRootJs,
+            wasmPath: helperRootWasm,
+            context: 'helper-root'
+        };
+    }
+    // Fallback: try relative to current working directory
+    const cwdPkg = path.resolve(process.cwd(), 'web', 'pkg');
+    const cwdJs = path.join(cwdPkg, 'wasm_wrapper.js');
+    const cwdWasm = path.join(cwdPkg, 'wasm_wrapper_bg.wasm');
+    if (fs.existsSync(cwdJs) && fs.existsSync(cwdWasm)) {
+        return {
+            jsPath: cwdJs,
+            wasmPath: cwdWasm,
+            context: 'cwd'
+        };
+    }
+    // Try web/dist from cwd
+    const cwdDist = path.resolve(process.cwd(), 'web', 'dist', 'wasm');
+    const cwdDistJs = path.join(cwdDist, 'wasm_wrapper.js');
+    const cwdDistWasm = path.join(cwdDist, 'wasm_wrapper_bg.wasm');
+    if (fs.existsSync(cwdDistJs) && fs.existsSync(cwdDistWasm)) {
+        return {
+            jsPath: cwdDistJs,
+            wasmPath: cwdDistWasm,
+            context: 'cwd'
+        };
+    }
+    throw new Error(`WASM files not found. Tried:\n` +
+        `  - ${rustHemRunnerJs}\n` +
+        `  - ${rustHemRunnerJsAlt}\n` +
+        `  - ${rustHemRunnerPkgJs}\n` +
+        `  - ${helperDistJs}\n` +
+        `  - ${helperRootJs}\n` +
+        `  - ${cwdJs}\n` +
+        `  - ${cwdDistJs}\n` +
+        `Please ensure WASM is built (run: scripts/deploy-wasm.sh --update)`);
+}
+/**
+ * Initialize WASM module for Node.js
+ * Reuses the same WASM bundle as browser/web workers
+ */
+let wasmModule = null;
+let wasmInitialized = false;
+let currentWorkspace = process.cwd(); // Default to cwd, updated per-tool call
+export async function initWasm() {
+    if (wasmInitialized && wasmModule) {
+        return wasmModule;
+    }
+    try {
+        const { jsPath, wasmPath, context } = resolveWasmPaths();
+        console.error(`[WASM] Loading from ${context}: ${jsPath}`);
+        // Prepare browser-like globals for wasm-bindgen-rayon (must be done BEFORE import)
+        // Match the CLI approach exactly
+        const global = globalThis;
+        if (!global.self) {
+            global.self = globalThis;
+        }
+        if (!global.window) {
+            global.window = globalThis;
+        }
+        if (typeof global.addEventListener !== 'function') {
+            global.addEventListener = () => { };
+        }
+        if (typeof global.postMessage !== 'function') {
+            global.postMessage = () => { };
+        }
+        if (typeof global.self.addEventListener !== 'function') {
+            global.self.addEventListener = () => { };
+        }
+        if (typeof global.self.postMessage !== 'function') {
+            global.self.postMessage = () => { };
+        }
+        if (typeof global.Worker !== 'function') {
+            global.Worker = class {
+                constructor() { }
+                addEventListener() { }
+                postMessage() { }
+                terminate() { }
+            };
+        }
+        // Set up file system bridge functions (like CLI does)
+        // These are called by WASM code via js_bridge
+        // They use currentWorkspace which is updated per-tool call
+        globalThis.write_file = (p, content) => {
+            const abs = path.isAbsolute(p) ? p : path.resolve(currentWorkspace, p);
+            try {
+                fs.mkdirSync(path.dirname(abs), { recursive: true });
+                fs.writeFileSync(abs, content);
+                return true;
+            }
+            catch (error) {
+                const err = error;
+                console.error(`[FS Bridge] write_file failed for ${abs}:`, err.message);
+                return false;
+            }
+        };
+        globalThis.read_file = (p) => {
+            const abs = path.isAbsolute(p) ? p : path.resolve(currentWorkspace, p);
+            try {
+                return fs.readFileSync(abs, 'utf8');
+            }
+            catch (error) {
+                const err = error;
+                console.error(`[FS Bridge] read_file failed for ${abs}:`, err.message);
+                throw error;
+            }
+        };
+        globalThis.file_exists = (p) => {
+            try {
+                const abs = path.isAbsolute(p) ? p : path.resolve(currentWorkspace, p);
+                return fs.existsSync(abs);
+            }
+            catch {
+                return false;
+            }
+        };
+        globalThis.create_dir_all = (p) => {
+            const abs = path.isAbsolute(p) ? p : path.resolve(currentWorkspace, p);
+            try {
+                fs.mkdirSync(abs, { recursive: true });
+                return true;
+            }
+            catch (error) {
+                const err = error;
+                console.error(`[FS Bridge] create_dir_all failed for ${abs}:`, err.message);
+                return false;
+            }
+        };
+        globalThis.list_dir = (p) => {
+            const abs = path.isAbsolute(p) ? p : path.resolve(currentWorkspace, p);
+            try {
+                return fs.readdirSync(abs);
+            }
+            catch (error) {
+                const err = error;
+                console.error(`[FS Bridge] list_dir failed for ${abs}:`, err.message);
+                return [];
+            }
+        };
+        // Polyfill fetch for file:// URLs (needed for wasm-bindgen-rayon workers)
+        // Must be set up BEFORE importing the WASM module
+        const originalFetch = globalThis.fetch;
+        globalThis.fetch = async (url, options) => {
+            // Handle file:// URLs
+            if (typeof url === 'string' && url.startsWith('file://')) {
+                const filePath = fileURLToPath(url);
+                try {
+                    const content = fs.readFileSync(filePath);
+                    // Use Response constructor if available, otherwise create a simple response-like object
+                    if (typeof Response !== 'undefined') {
+                        return new Response(content, {
+                            status: 200,
+                            statusText: 'OK',
+                            headers: { 'Content-Type': 'application/javascript' }
+                        });
+                    }
+                    else {
+                        // Fallback for environments without Response
+                        return {
+                            ok: true,
+                            status: 200,
+                            statusText: 'OK',
+                            async text() { return content.toString(); },
+                            async arrayBuffer() { return content.buffer; },
+                            headers: new Map([['Content-Type', 'application/javascript']])
+                        };
+                    }
+                }
+                catch (error) {
+                    if (typeof Response !== 'undefined') {
+                        return new Response(null, {
+                            status: 404,
+                            statusText: 'Not Found'
+                        });
+                    }
+                    else {
+                        return {
+                            ok: false,
+                            status: 404,
+                            statusText: 'Not Found',
+                            async text() { return ''; },
+                            async arrayBuffer() { return new ArrayBuffer(0); },
+                            headers: new Map()
+                        };
+                    }
+                }
+            }
+            // Fall back to original fetch for other URLs
+            if (originalFetch) {
+                return originalFetch(url, options);
+            }
+            throw new Error('fetch not available for non-file URLs');
+        };
+        // Import WASM module using file:// URL (required for ES modules)
+        // This matches the CLI approach: import then initSync
+        const wasmModuleUrl = pathToFileURL(jsPath).href;
+        wasmModule = await import(wasmModuleUrl);
+        // Use initSync with bytes (matches CLI approach exactly)
+        // This avoids the async default() path which triggers rayon worker fetch
+        if (wasmModule.initSync) {
+            const wasmBytes = fs.readFileSync(wasmPath);
+            wasmModule.initSync({ module: wasmBytes });
+        }
+        else {
+            throw new Error('WASM module does not have initSync - this should not happen with wasm-pack build');
+        }
+        // Setup panic hook for better error messages
+        if (wasmModule.setup_panic_hook) {
+            wasmModule.setup_panic_hook();
+        }
+        wasmInitialized = true;
+        console.error(`[WASM] Initialized successfully from ${context}`);
+        return wasmModule;
+    }
+    catch (error) {
+        console.error('[WASM] Initialization failed:', error);
+        wasmModule = null;
+        wasmInitialized = false;
+        const err = error;
+        throw new Error(`WASM initialization failed: ${err.message}`);
+    }
+}
+/**
+ * Get initialized WASM module (throws if not initialized)
+ */
+export function getWasmModule() {
+    if (!wasmModule || !wasmInitialized) {
+        throw new Error('WASM module not initialized. Call initWasm() first.');
+    }
+    return wasmModule;
+}
+/**
+ * Set the current workspace for file system bridge functions
+ * This should be called before each WASM operation that uses file I/O
+ */
+export function setWorkspace(workspace) {
+    currentWorkspace = workspace;
+}
+//# sourceMappingURL=wasm.js.map

package/dist/src/engine/wasm.js.map

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

package/dist/src/engine/workspace.d.ts

@@ -0,0 +1,23 @@
+export interface MCPConfig {
+    workspace: string;
+    user_id: string;
+    configPath: string;
+}
+/**
+ * Read and validate MCP config file
+ *
+ * If configPath is not provided, looks for vulcan-mcp-config.json in current working directory.
+ *
+ * Helper refuses to start if:
+ * - Config file missing
+ * - Config file invalid JSON
+ * - Config missing user_id field or user_id is empty
+ * - Config missing workspace field
+ * - Workspace directory doesn't exist
+ * - Workspace doesn't look like a Vulcan project (input/batch_parameters directory missing)
+ *
+ * MCP only supports folder (FSA) workspaces backed by the real filesystem.
+ * OPFS workspaces are explicitly unsupported.
+ */
+export declare function readConfig(configPath?: string): Promise<MCPConfig>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/src/engine/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/engine/workspace.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmExE"}

package/dist/src/engine/workspace.js

@@ -0,0 +1,82 @@
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Read and validate MCP config file
+ *
+ * If configPath is not provided, looks for vulcan-mcp-config.json in current working directory.
+ *
+ * Helper refuses to start if:
+ * - Config file missing
+ * - Config file invalid JSON
+ * - Config missing user_id field or user_id is empty
+ * - Config missing workspace field
+ * - Workspace directory doesn't exist
+ * - Workspace doesn't look like a Vulcan project (input/batch_parameters directory missing)
+ *
+ * MCP only supports folder (FSA) workspaces backed by the real filesystem.
+ * OPFS workspaces are explicitly unsupported.
+ */
+export async function readConfig(configPath) {
+    let resolvedPath = configPath;
+    // If no config path provided, try to find it
+    if (!resolvedPath) {
+        // Try VULCAN_WORKSPACE env var
+        const workspace = process.env.VULCAN_WORKSPACE;
+        if (workspace) {
+            resolvedPath = path.join(workspace, 'vulcan-mcp-config.json');
+        }
+        else {
+            // Try current directory (default behavior per PRD)
+            resolvedPath = path.join(process.cwd(), 'vulcan-mcp-config.json');
+        }
+    }
+    // Resolve to absolute path
+    resolvedPath = path.resolve(resolvedPath);
+    // Read config file
+    let configContent;
+    try {
+        configContent = await fs.readFile(resolvedPath, 'utf-8');
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Config file not found: ${resolvedPath}. Please generate it from Vulcan → Integrations → MCP.`);
+    }
+    let config;
+    try {
+        config = JSON.parse(configContent);
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Invalid JSON in config file: ${err.message}`);
+    }
+    // Validate required fields
+    if (!config.workspace) {
+        throw new Error('Config file missing required field: workspace');
+    }
+    if (!config.user_id || config.user_id.trim() === '') {
+        throw new Error('MCP is only available for logged-in Vulcan users. Open Vulcan → Integrations → MCP to generate a config file.');
+    }
+    // Resolve workspace path
+    const workspacePath = path.resolve(path.dirname(resolvedPath), config.workspace);
+    // Verify workspace exists
+    try {
+        await fs.access(workspacePath);
+    }
+    catch (error) {
+        throw new Error(`Workspace directory not found: ${workspacePath}`);
+    }
+    // Verify workspace structure (FSA workspace check)
+    const batchParamsDir = path.join(workspacePath, 'input', 'batch_parameters');
+    try {
+        await fs.access(batchParamsDir);
+    }
+    catch (error) {
+        throw new Error(`Workspace missing required directory: ${batchParamsDir}. MCP only supports folder (FSA) workspaces backed by the real filesystem.`);
+    }
+    return {
+        workspace: workspacePath,
+        user_id: config.user_id,
+        configPath: resolvedPath
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/src/engine/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/engine/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAmB;IAClD,IAAI,YAAY,GAAG,UAAU,CAAC;IAE9B,6CAA6C;IAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,+BAA+B;QAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC/C,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,mDAAmD;YACnD,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,wBAAwB,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1C,mBAAmB;IACnB,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAA8B,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,wDAAwD,CAAC,CAAC;IAClH,CAAC;IAED,IAAI,MAAgD,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAc,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,+GAA+G,CAAC,CAAC;IACnI,CAAC;IAED,yBAAyB;IACzB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAEjF,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,aAAa,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,mDAAmD;IACnD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yCAAyC,cAAc,4EAA4E,CAAC,CAAC;IACvJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,YAAY;KACzB,CAAC;AACJ,CAAC"}

package/dist/src/server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Start the MCP helper server
+ *
+ * @param configPath Optional path to vulcan-mcp-config.json (defaults to ./vulcan-mcp-config.json)
+ * @param port Optional port number (defaults to 5000)
+ */
+export declare function startServer(configPath?: string, port?: number): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqKnF"}

package/dist/src/server.js

@@ -0,0 +1,166 @@
+import express from 'express';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, InitializeRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { readConfig } from './engine/workspace.js';
+import { initWasm } from './engine/wasm.js';
+import { toolDefinitions, handleToolCall } from './tools/index.js';
+/**
+ * Start the MCP helper server
+ *
+ * @param configPath Optional path to vulcan-mcp-config.json (defaults to ./vulcan-mcp-config.json)
+ * @param port Optional port number (defaults to 5000)
+ */
+export async function startServer(configPath, port) {
+    const httpPort = port || parseInt(process.env.HELPER_PORT || '5000', 10);
+    // Load and validate config (refuses to start if invalid)
+    let config;
+    try {
+        config = await readConfig(configPath);
+        console.error(`[MCP Helper] Config loaded from: ${config.configPath}`);
+        console.error(`[MCP Helper] Workspace: ${config.workspace}`);
+    }
+    catch (error) {
+        const err = error;
+        console.error(`[MCP Helper] Failed to load config: ${err.message}`);
+        process.exit(1);
+    }
+    // Initialize WASM
+    try {
+        await initWasm();
+        console.error('[MCP Helper] WASM initialized');
+    }
+    catch (error) {
+        const err = error;
+        console.error(`[MCP Helper] WASM initialization failed: ${err.message}`);
+        process.exit(1);
+    }
+    // Create Express app
+    const app = express();
+    // IMPORTANT: MCP transport handler must be mounted before any body parsers
+    // or middleware that consume the request stream, to avoid interfering with streaming
+    // We parse JSON body manually for /mcp to avoid Express body parser interfering with streaming
+    // Create MCP server instance
+    const mcpServer = new Server({
+        name: 'vulcan-mcp-helper',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Accept legacy initialize payloads (for Cursor compatibility)
+    const originalOnInitialize = mcpServer._oninitialize?.bind(mcpServer);
+    if (originalOnInitialize) {
+        mcpServer.removeRequestHandler('initialize');
+        const LegacyInitializeSchema = InitializeRequestSchema.extend({
+            params: InitializeRequestSchema.shape.params
+                .partial()
+                .transform((params = {}) => ({
+                protocolVersion: params.protocolVersion || '2024-11-05',
+                capabilities: params.capabilities || {},
+                clientInfo: params.clientInfo || { name: 'unknown-client', version: '0.0.0' },
+            })),
+        });
+        mcpServer.setRequestHandler(LegacyInitializeSchema, (request) => originalOnInitialize(request));
+    }
+    // Register tools
+    mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: toolDefinitions };
+    });
+    mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: toolArgs } = request.params;
+        console.error(`[MCP Helper] Tool call: ${name}`);
+        try {
+            const result = await handleToolCall(name, toolArgs, config);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            const err = error;
+            console.error(`[MCP Helper] Tool call failed: ${err.message}`);
+            throw err;
+        }
+    });
+    // MCP endpoint - must be mounted BEFORE Express body parsers
+    // Parse JSON body manually to avoid Express body parser interfering with MCP streaming
+    app.post('/mcp', express.raw({ type: 'application/json', limit: '10mb' }), async (req, res) => {
+        let requestBody;
+        try {
+            // Parse JSON body manually
+            const bodyText = req.body.toString('utf-8');
+            requestBody = JSON.parse(bodyText);
+        }
+        catch (error) {
+            const err = error;
+            res.status(400).json({
+                jsonrpc: '2.0',
+                error: {
+                    code: -32700,
+                    message: 'Parse error',
+                    data: err.message,
+                },
+                id: null,
+            });
+            return;
+        }
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+            enableJsonResponse: true,
+        });
+        res.on('close', () => {
+            transport.close();
+        });
+        try {
+            await mcpServer.connect(transport);
+            await transport.handleRequest(req, res, requestBody);
+        }
+        catch (error) {
+            const err = error;
+            console.error(`[MCP Helper] MCP request failed: ${err.message}`);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32603,
+                        message: 'Internal server error',
+                        data: err.message,
+                    },
+                    id: requestBody?.id || null,
+                });
+            }
+        }
+    });
+    // Health check endpoint
+    app.get('/health', (req, res) => {
+        res.json({
+            status: 'running',
+            port: httpPort,
+            version: '0.1.0',
+            name: 'vulcan-mcp-helper',
+        });
+    });
+    // Helper status endpoint (for web app - read-only)
+    app.get('/helper/status', (req, res) => {
+        res.json({
+            running: true,
+            port: httpPort,
+            version: '0.1.0',
+            mcpReady: true,
+        });
+    });
+    // Start server
+    app.listen(httpPort, '127.0.0.1', () => {
+        console.error(`[MCP Helper] Server running on http://127.0.0.1:${httpPort}`);
+        console.error(`[MCP Helper] MCP endpoint: http://127.0.0.1:${httpPort}/mcp`);
+        console.error(`[MCP Helper] Health check: http://127.0.0.1:${httpPort}/health`);
+        console.error(`[MCP Helper] Status API: http://127.0.0.1:${httpPort}/helper/status`);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAA8B,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAkB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAmB,EAAE,IAAa;IAClE,MAAM,QAAQ,GAAG,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzE,yDAAyD;IACzD,IAAI,MAAiB,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,oCAAoC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAc,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,uCAAuC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC;QACH,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAc,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,4CAA4C,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,qBAAqB;IACrB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,2EAA2E;IAC3E,qFAAqF;IACrF,+FAA+F;IAE/F,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,MAAM,CAC1B;QACE,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,+DAA+D;IAC/D,MAAM,oBAAoB,GAAI,SAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/E,IAAI,oBAAoB,EAAE,CAAC;QACzB,SAAS,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,sBAAsB,GAAG,uBAAuB,CAAC,MAAM,CAAC;YAC5D,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,MAAM;iBACzC,OAAO,EAAE;iBACT,SAAS,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3B,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,YAAY;gBACvD,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;gBACvC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE;aAC9E,CAAC,CAAC;SACN,CAAC,CAAC;QACH,SAAS,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,iBAAiB;IACjB,SAAS,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC7D,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACnE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;QAEjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6DAA6D;IAC7D,uFAAuF;IACvF,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC/G,IAAI,WAAgB,CAAC;QACrB,IAAI,CAAC;YACH,2BAA2B;YAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5C,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,CAAC,KAAK;oBACZ,OAAO,EAAE,aAAa;oBACtB,IAAI,EAAE,GAAG,CAAC,OAAO;iBAClB;gBACD,EAAE,EAAE,IAAI;aACT,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,kBAAkB,EAAE,SAAS;YAC7B,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,KAAK;wBACZ,OAAO,EAAE,uBAAuB;wBAChC,IAAI,EAAE,GAAG,CAAC,OAAO;qBAClB;oBACD,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,IAAI;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACjD,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,mBAAmB;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,mDAAmD;IACnD,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACxD,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,KAAK,CAAC,+CAA+C,QAAQ,MAAM,CAAC,CAAC;QAC7E,OAAO,CAAC,KAAK,CAAC,+CAA+C,QAAQ,SAAS,CAAC,CAAC;QAChF,OAAO,CAAC,KAAK,CAAC,6CAA6C,QAAQ,gBAAgB,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC"}