@akiojin/unity-mcp-server 2.42.2 → 2.42.4

package/bin/bootstrap.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * Bootstrap wrapper for unity-mcp-server
+ *
+ * This wrapper ensures:
+ * 1. Early stderr output before any module loading
+ * 2. Global exception handlers are registered first
+ * 3. Module load failures are caught and reported
+ *
+ * ESM static imports are hoisted, so we use dynamic import() to
+ * ensure our error handlers are set up before loading the main module.
+ */
+
+// Synchronous stderr write - this MUST appear before any module loading
+process.stderr.write('[unity-mcp-server] Bootstrap starting...\n');
+
+// Global exception handlers - catch any unhandled errors
+process.on('uncaughtException', err => {
+  process.stderr.write(`[unity-mcp-server] FATAL: Uncaught exception: ${err.message}\n`);
+  process.stderr.write(`${err.stack}\n`);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason, _promise) => {
+  const msg = reason instanceof Error ? reason.message : String(reason);
+  const stack = reason instanceof Error ? reason.stack : '';
+  process.stderr.write(`[unity-mcp-server] FATAL: Unhandled rejection: ${msg}\n`);
+  if (stack) process.stderr.write(`${stack}\n`);
+  process.exit(1);
+});
+
+// Dynamic import to load the main module AFTER error handlers are set up
+// This allows us to catch module load failures
+import('./unity-mcp-server').catch(err => {
+  process.stderr.write(`[unity-mcp-server] FATAL: Module load failed: ${err.message}\n`);
+  process.stderr.write(`${err.stack}\n`);
+  process.exit(1);
+});

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@akiojin/unity-mcp-server",
-  "version": "2.42.2",
+  "version": "2.42.4",
   "description": "MCP server and Unity Editor bridge — enables AI assistants to control Unity for AI-assisted workflows",
   "type": "module",
   "main": "src/core/server.js",
   "bin": {
-    "unity-mcp-server": "./bin/unity-mcp-server"
+    "unity-mcp-server": "./bin/bootstrap.js"
   },
   "scripts": {
     "start": "node src/core/server.js",
@@ -29,7 +29,7 @@
     "prebuild:better-sqlite3": "node scripts/prebuild-better-sqlite3.mjs",
     "prebuilt:manifest": "node scripts/generate-prebuilt-manifest.mjs",
     "prepublishOnly": "npm run test:ci && npm run prebuilt:manifest",
-    "postinstall": "node scripts/ensure-better-sqlite3.mjs && chmod +x bin/unity-mcp-server || true",
+    "postinstall": "node scripts/ensure-better-sqlite3.mjs && chmod +x bin/bootstrap.js bin/unity-mcp-server || true",
     "test:ci:unity": "timeout 60 node --test tests/unit/core/codeIndex.test.js tests/unit/core/config.test.js tests/unit/core/indexWatcher.test.js tests/unit/core/projectInfo.test.js tests/unit/core/server.test.js || exit 0",
     "test:unity": "node tests/run-unity-integration.mjs",
     "test:nounity": "npm run test:integration",

package/src/core/config.js

@@ -1,6 +1,10 @@
 import fs from 'fs';
 import path from 'path';
 import * as findUpPkg from 'find-up';
+
+// Diagnostic log: confirm module loading reached this point
+process.stderr.write('[unity-mcp-server] Config module loading...\n');
+
 function findUpSyncCompat(matcher, options = {}) {
   if (typeof matcher === 'function') {
     let dir = options.cwd || process.cwd();

package/src/core/unityConnection.js

@@ -21,6 +21,7 @@ export class UnityConnection extends EventEmitter {
     this.sendQueue = [];
     this.inFlight = 0;
     this.maxInFlight = 1; // process one command at a time by default
+    this.connectedAt = null; // Timestamp when connection was established
   }
 
   /**
@@ -77,8 +78,11 @@ export class UnityConnection extends EventEmitter {
 
       // Set up event handlers
       this.socket.on('connect', () => {
-        console.error(`[unity-mcp-server] Unity TCP connected successfully`);
-        logger.info('Connected to Unity Editor');
+        this.connectedAt = Date.now();
+        console.error(
+          `[unity-mcp-server] Unity TCP connected to ${targetHost}:${config.unity.port}`
+        );
+        logger.info(`Connected to Unity Editor at ${targetHost}:${config.unity.port}`);
         this.connected = true;
         this.reconnectAttempts = 0;
         this.connectPromise = null;
@@ -88,6 +92,12 @@ export class UnityConnection extends EventEmitter {
       });
 
       this.socket.on('end', () => {
+        // Unity closed the connection (FIN received)
+        const duration = this.connectedAt ? Date.now() - this.connectedAt : 0;
+        console.error(
+          `[unity-mcp-server] Unity TCP connection ended by remote (FIN received, duration: ${duration}ms)`
+        );
+        logger.info(`Unity closed connection (FIN received) after ${duration}ms`);
         // Treat end as close to trigger reconnection
         this.socket.destroy();
       });
@@ -130,9 +140,11 @@ export class UnityConnection extends EventEmitter {
           return;
         }
 
-        console.error(`[unity-mcp-server] Unity TCP disconnected`);
-        logger.info('Disconnected from Unity Editor');
+        const duration = this.connectedAt ? Date.now() - this.connectedAt : 0;
+        console.error(`[unity-mcp-server] Unity TCP disconnected (duration: ${duration}ms)`);
+        logger.info(`Disconnected from Unity Editor after ${duration}ms`);
         this.connected = false;
+        this.connectedAt = null;
         this.socket = null;
 
         // Clear message buffer
@@ -231,6 +243,9 @@ export class UnityConnection extends EventEmitter {
    * @param {Buffer} data
    */
   handleData(data) {
+    // Log received data size for debugging connection issues
+    console.error(`[unity-mcp-server] Received ${data.length} bytes from Unity`);
+
     // Fast-path: accept single unframed JSON message (NDJSON style) from tests/clients
     if (!this.messageBuffer.length) {
       const asString = data.toString('utf8').trim();