unreal-engine-mcp-server 0.4.7 → 0.5.0

package/scripts/validate-server.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { readFile } from 'fs/promises';
+
+async function validateServerJson() {
+  try {
+    // Read the server.json file
+    const serverJson = JSON.parse(await readFile('server.json', 'utf8'));
+
+    console.log('✅ server.json is valid JSON!');
+    console.log('📋 Server Information:');
+    console.log(`   - Name: ${serverJson.name}`);
+    console.log(`   - Version: ${serverJson.version}`);
+    console.log(`   - Description: ${serverJson.description}`);
+    console.log(`   - Package Count: ${serverJson.packages?.length || 0}`);
+    console.log(`   - Keywords: ${serverJson.keywords?.length || 0} tags`);
+    console.log(`   - Environment Variables: ${serverJson.packages?.[0]?.environmentVariables?.length || 0}`);
+
+    // Basic structure validation
+    const requiredFields = ['name', 'description', 'version', 'packages'];
+    const missingFields = requiredFields.filter(field => !serverJson[field]);
+
+    if (missingFields.length > 0) {
+      console.log(`⚠️  Missing required fields: ${missingFields.join(', ')}`);
+      return false;
+    }
+
+    // Validate package structure
+    if (serverJson.packages && serverJson.packages.length > 0) {
+      const pkg = serverJson.packages[0];
+      if (!pkg.identifier || !pkg.registryType || !pkg.transport) {
+        console.log('⚠️  Package missing required fields (identifier, registryType, transport)');
+        return false;
+      }
+    }
+
+    console.log('✅ server.json structure validation passed!');
+    console.log('✅ Ready for MCP Registry submission!');
+    return true;
+
+  } catch (error) {
+    console.error('❌ Validation error:', error.message);
+    return false;
+  }
+}
+
+validateServerJson();

package/scripts/verify-automation-bridge.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(__dirname, '..');
+
+function ok(msg) { console.log(`[ok] ${msg}`); }
+function warn(msg) { console.warn(`[warn] ${msg}`); }
+function fail(msg) { console.error(`[fail] ${msg}`); process.exitCode = 1; }
+
+try {
+  const pluginDir = path.resolve(repoRoot, 'plugins', 'McpAutomationBridge');
+  if (fs.existsSync(pluginDir)) ok(`Plugin folder found: ${pluginDir}`); else fail(`Plugin folder missing: ${pluginDir}`);
+  const uplugin = path.join(pluginDir, 'McpAutomationBridge.uplugin');
+  if (fs.existsSync(uplugin)) ok('uplugin present'); else warn('uplugin missing');
+  const port = process.env.MCP_AUTOMATION_WS_PORT || '8090';
+  ok(`Configured port: ${port}`);
+  console.log('Verification complete.');
+} catch (e) {
+  fail(e?.message || String(e));
+}
+
+  summary.pythonFlags = requiredPythonSettings.reduce((acc, setting) => {
+    acc[setting] = lower.includes(setting);
+    return acc;
+  }, {});
+
+  if (!summary.hasBridgeEntry) {
+    summary.warnings.push('DefaultEngine.ini does not contain a +Plugins entry for McpAutomationBridge. Enable it via Edit ▸ Plugins or add a Plugins section.');
+  }
+
+  for (const [key, present] of Object.entries(summary.remoteControl)) {
+    if (!present) {
+      summary.warnings.push(`Remote Control setting missing: ${key}`);
+    }
+  }
+
+  for (const [key, present] of Object.entries(summary.pythonFlags)) {
+    if (!present) {
+      summary.warnings.push(`Python execution setting missing: ${key}`);
+    }
+  }
+
+  return summary;
+}
+
+function checkEnvironment() {
+  const envSummary = {
+    mcpAutomationBridgeEnabled: process.env.MCP_AUTOMATION_BRIDGE_ENABLED !== 'false',
+    host: process.env.MCP_AUTOMATION_WS_HOST || '127.0.0.1',
+    port: process.env.MCP_AUTOMATION_WS_PORT || '8090',
+    capabilityTokenConfigured: Boolean(process.env.MCP_AUTOMATION_CAPABILITY_TOKEN),
+    ueHost: process.env.UE_HOST || '127.0.0.1',
+    ueHttpPort: process.env.UE_RC_HTTP_PORT || '30010',
+    ueWsPort: process.env.UE_RC_WS_PORT || '30020',
+    warnings: []
+  };
+
+  if (process.env.MCP_AUTOMATION_BRIDGE_ENABLED === 'false') {
+    envSummary.warnings.push('MCP_AUTOMATION_BRIDGE_ENABLED is set to false. The WebSocket listener will not start.');
+  }
+
+  if (!process.env.MCP_AUTOMATION_CAPABILITY_TOKEN) {
+    envSummary.warnings.push('No MCP_AUTOMATION_CAPABILITY_TOKEN set. Omit for local testing or define one to require handshakes.');
+  }
+
+  return envSummary;
+}
+
+function printHumanReport(report) {
+  const {
+    pluginChecks,
+    configCheck,
+    environment
+  } = report;
+
+  const divider = () => console.log('----------------------------------------');
+
+  console.log('Automation Bridge Verification Report');
+  divider();
+
+  if (pluginChecks.length === 0) {
+    console.log('No plugin directories inspected (pass --engine and/or --project).');
+  } else {
+    for (const check of pluginChecks) {
+      console.log(`${check.label}: ${check.pluginPath}`);
+      if (check.errors.length > 0) {
+        for (const error of check.errors) {
+          console.log(`  [error] ${error}`);
+        }
+      } else {
+        console.log('  status: OK');
+        if (check.descriptor) {
+          console.log(`  descriptor: v${check.descriptor.versionName || check.descriptor.version || 'unknown'}`);
+        }
+        if (check.warnings.length > 0) {
+          for (const warn of check.warnings) {
+            console.log(`  [warning] ${warn}`);
+          }
+        }
+      }
+      divider();
+    }
+  }
+
+  if (configCheck.path) {
+    console.log(`DefaultEngine.ini: ${configCheck.path}`);
+    if (configCheck.errors.length > 0) {
+      for (const error of configCheck.errors) {
+        console.log(`  [error] ${error}`);
+      }
+    } else {
+      console.log(`  has MCPAutomationBridge entry: ${configCheck.hasBridgeEntry ? 'yes' : 'no'}`);
+      for (const [setting, present] of Object.entries(configCheck.remoteControl)) {
+        console.log(`  Remote Control ${setting}: ${present ? 'yes' : 'missing'}`);
+      }
+      for (const [setting, present] of Object.entries(configCheck.pythonFlags)) {
+        console.log(`  Python ${setting}: ${present ? 'yes' : 'missing'}`);
+      }
+      for (const warn of configCheck.warnings) {
+        console.log(`  [warning] ${warn}`);
+      }
+    }
+    divider();
+  }
+
+  console.log('Environment variables:');
+  console.log(`  MCP_AUTOMATION_BRIDGE_ENABLED=${environment.mcpAutomationBridgeEnabled}`);
+  console.log(`  MCP_AUTOMATION_WS_HOST=${environment.host}`);
+  console.log(`  MCP_AUTOMATION_WS_PORT=${environment.port}`);
+  console.log(`  MCP_AUTOMATION_CAPABILITY_TOKEN=${environment.capabilityTokenConfigured ? '[set]' : '[not set]'}`);
+  console.log(`  UE_HOST=${environment.ueHost}`);
+  console.log(`  UE_RC_HTTP_PORT=${environment.ueHttpPort}`);
+  console.log(`  UE_RC_WS_PORT=${environment.ueWsPort}`);
+  for (const warn of environment.warnings) {
+    console.log(`  [warning] ${warn}`);
+  }
+  divider();
+
+  console.log('Next steps:');
+  if (pluginChecks.some((check) => check.errors.length > 0)) {
+    console.log('- Re-run scripts/sync-mcp-plugin.js with the appropriate --engine/--project paths.');
+  }
+  if (configCheck.warnings.length > 0 || configCheck.errors.length > 0) {
+    console.log('- Update Config/DefaultEngine.ini and enable the plugin in Edit ▸ Plugins.');
+  }
+  if (environment.warnings.length > 0) {
+    console.log('- Review environment variables (set MCP_AUTOMATION_CAPABILITY_TOKEN for secured deployments).');
+  }
+  if (
+    pluginChecks.every((check) => check.errors.length === 0) &&
+    configCheck.errors.length === 0 &&
+    environment.warnings.length === 0
+  ) {
+    console.log('- Everything looks good. Launch Unreal and watch the Output Log for the bridge handshake.');
+  }
+}
+
+function main() {
+  const args = parseArgs(process.argv);
+  if (args.help) {
+    showHelp();
+    return;
+  }
+
+  const pluginChecks = [];
+  const uniqueLabels = new Set();
+  if (args.engine) {
+    pluginChecks.push(checkPluginInstall(args.engine, 'Engine plugin'));
+    uniqueLabels.add('engine');
+  }
+  if (args.project) {
+    pluginChecks.push(checkPluginInstall(args.project, 'Project plugin'));
+    uniqueLabels.add('project');
+  }
+
+  const configCheck = parseIniForSettings(args.config);
+  const environment = checkEnvironment();
+
+  const report = {
+    pluginChecks: pluginChecks.filter(Boolean),
+    configCheck,
+    environment
+  };
+
+  if (args.json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    printHumanReport(report);
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(`Verification failed: ${error.message}`);
+  process.exitCode = 1;
+}

package/server.json

@@ -1,47 +1,76 @@
 {
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-16/server.schema.json",
   "name": "io.github.ChiR24/unreal-engine-mcp",
-  "description": "MCP server for Unreal Engine 5 with 13 tools for game development automation.",
-  "version": "0.4.7",
+  "description": "MCP server for Unreal Engine 5 with 17 tools for game development automation.",
+  "version": "0.5.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "unreal-engine-mcp-server",
-      "version": "0.4.7",
+      "version": "0.5.0",
       "transport": {
         "type": "stdio"
       },
       "environmentVariables": [
         {
-          "name": "UE_HOST",
-          "description": "Unreal Engine host address (default: 127.0.0.1)",
+          "name": "LOG_LEVEL",
+          "description": "Logging level: debug, info, warn, error (default: info)",
           "isRequired": false,
-          "value": "127.0.0.1"
+          "value": "info"
         },
         {
-          "name": "UE_RC_HTTP_PORT",
-          "description": "Remote Control HTTP port (default: 30010)",
+          "name": "MCP_ROUTE_STDOUT_LOGS",
+          "description": "Route standard output to standard error to avoid protocol corruption (default: true)",
           "isRequired": false,
-          "value": "30010"
+          "value": "true"
         },
         {
-          "name": "UE_RC_WS_PORT",
-          "description": "Remote Control WebSocket port (default: 30020)",
+          "name": "UE_PROJECT_PATH",
+          "description": "Absolute path to your Unreal .uproject file",
           "isRequired": false,
-          "value": "30020"
+          "value": "C:/Users/YourName/Documents/Unreal Projects/YourProject"
         },
         {
-          "name": "LOG_LEVEL",
-          "description": "Logging level: debug, info, warn, error (default: info)",
+          "name": "UE_EDITOR_EXE",
+          "description": "Path to UnrealEditor-Cmd.exe (optional)",
           "isRequired": false,
-          "value": "info"
+          "value": ""
         },
         {
-          "name": "UE_PROJECT_PATH",
-          "description": "Absolute path to your Unreal .uproject file",
+          "name": "UE_SCREENSHOT_DIR",
+          "description": "Directory to save screenshots (optional)",
           "isRequired": false,
-          "value": "C:/Users/YourName/Documents/Unreal Projects/YourProject"
+          "value": ""
+        },
+        {
+          "name": "MCP_AUTOMATION_PORT",
+          "description": "Automation bridge WebSocket port (default: 8091)",
+          "isRequired": false,
+          "value": "8091"
+        },
+        {
+          "name": "MCP_AUTOMATION_HOST",
+          "description": "Automation bridge WebSocket host (default: 127.0.0.1)",
+          "isRequired": false,
+          "value": "127.0.0.1"
+        },
+        {
+          "name": "MCP_AUTOMATION_CLIENT_MODE",
+          "description": "Run as client connecting to UE (false) or server listening for UE (true) (default: false)",
+          "isRequired": false,
+          "value": "false"
+        },
+        {
+          "name": "MCP_CONNECTION_TIMEOUT_MS",
+          "description": "Connection timeout in milliseconds (default: 5000)",
+          "isRequired": false,
+          "value": "5000"
+        },
+        {
+          "name": "MCP_REQUEST_TIMEOUT_MS",
+          "description": "Request timeout in milliseconds (default: 30000)",
+          "isRequired": false,
+          "value": "30000"
         }
       ]
     }
@@ -54,7 +83,6 @@
     "ue5",
     "ue6",
     "game-development",
-    "remote-control",
     "automation",
     "3d",
     "gamedev",
@@ -71,7 +99,15 @@
     "asset-management",
     "actor-control",
     "sequencer",
-    "production"
+    "production",
+    "audio",
+    "behavior-tree",
+    "input",
+    "performance",
+    "landscape",
+    "foliage",
+    "profiling",
+    "world-partition"
   ],
   "author": "ChiR24",
   "homepage": "https://github.com/ChiR24/Unreal_mcp",