refactor(utils): rename McpConfigUtils → McpUtils

feat: Unity now installs the Node.js server and it's dependencies
- automatically runs on Unity starts
- add “Force Install Server” button for manual invoke

chore(node.js): remove build/ and node_modules/ folders as now they are built by Unity on start

chore(unity): port variable is now saved in the MCP settings

docs: sync all readme files
- remove extra FAQs
- replace OS-specific timeout sections with generic instructions
- append standardized Support/Feedback, Contributing, License, Acknowledgements

Author: CoderGamester

.gitignore

@@ -115,7 +115,9 @@ GvhProjectSettings.xml
 **/package-lock.json.meta
 .codeiumignore
 .windsurf
-Server/log.txt
-Server/log.txt.meta
+Server~/log.txt
+Server~/log.txt.meta
 log.txt
 log.txt.meta
+Server~/build/*
+Server~/node_modules/*

Editor/UnityBridge/McpUnityEditorWindow.cs

@@ -164,8 +164,8 @@ private void DrawServerTab()
 
             GUI.enabled = true;
             EditorGUILayout.EndHorizontal();
-            
-            EditorGUILayout.Space();
+
+            EditorGUILayout.Space(); 
 
             EditorGUILayout.LabelField("Connected Clients", EditorStyles.boldLabel);
             EditorGUILayout.BeginVertical("box"); // Keep the default gray box for the container
@@ -210,7 +210,7 @@ private void DrawServerTab()
 
             if (string.IsNullOrEmpty(_mcpConfigJson) || before != _tabsIndentationJson)
             {
-                _mcpConfigJson = McpConfigUtils.GenerateMcpConfigJson(_tabsIndentationJson);
+                _mcpConfigJson = McpUtils.GenerateMcpConfigJson(_tabsIndentationJson);
             }
 
             if (GUILayout.Button("Copy to Clipboard", GUILayout.Height(30)))
@@ -224,7 +224,7 @@ private void DrawServerTab()
 
             if (GUILayout.Button("Configure Windsurf IDE", GUILayout.Height(30)))
             {
-                bool added = McpConfigUtils.AddToWindsurfIdeConfig(_tabsIndentationJson);
+                bool added = McpUtils.AddToWindsurfIdeConfig(_tabsIndentationJson);
                 if (added)
                 {
                     EditorUtility.DisplayDialog("Success", "The MCP configuration was successfully added to the Windsurf config file.", "OK");
@@ -239,7 +239,7 @@ private void DrawServerTab()
 
             if (GUILayout.Button("Configure Claude Desktop", GUILayout.Height(30)))
             {
-                bool added = McpConfigUtils.AddToClaudeDesktopConfig(_tabsIndentationJson);
+                bool added = McpUtils.AddToClaudeDesktopConfig(_tabsIndentationJson);
                 if (added)
                 {
                     EditorUtility.DisplayDialog("Success", "The MCP configuration was successfully added to the Claude Desktop config file.", "OK");
@@ -254,7 +254,7 @@ private void DrawServerTab()
 
             if (GUILayout.Button("Configure Cursor", GUILayout.Height(30)))
             {
-                bool added = McpConfigUtils.AddToCursorConfig(_tabsIndentationJson);
+                bool added = McpUtils.AddToCursorConfig(_tabsIndentationJson);
                 if (added)
                 {
                     EditorUtility.DisplayDialog("Success", "The MCP configuration was successfully added to the Cursor config file.", "OK");
@@ -266,6 +266,14 @@ private void DrawServerTab()
             }
 
             EditorGUILayout.EndVertical();
+            
+            EditorGUILayout.Space(); 
+
+            // Force Install Server button
+            if (GUILayout.Button("Force Install Server", GUILayout.Height(30)))
+            {
+                McpUnityServer.Instance.InstallServer();
+            }
         }
 
         private void DrawHelpTab()

Editor/UnityBridge/McpUnityServer.cs

@@ -8,6 +8,8 @@
 using McpUnity.Services;
 using McpUnity.Utils;
 using WebSocketSharp.Server;
+using System.IO;
+using System.Diagnostics;
 
 namespace McpUnity.Unity
 {
@@ -74,6 +76,7 @@ public static McpUnityServer Instance
         /// </summary>
         private McpUnityServer()
         {
+            InstallServer(); 
             InitializeServices();
             RegisterResources();
             RegisterTools();
@@ -138,6 +141,33 @@ public bool TryGetResource(string name, out McpResourceBase resource)
         {
             return _resources.TryGetValue(name, out resource);
         }
+
+        /// <summary>
+        /// Installs the MCP Node.js server by running 'npm install' and 'npm run build'
+        /// in the server directory if 'node_modules' or 'build' folders are missing.
+        /// </summary>
+        public void InstallServer()
+        {
+            string serverPath = McpUtils.GetServerPath();
+
+            if (string.IsNullOrEmpty(serverPath) || !Directory.Exists(serverPath))
+            {
+                McpLogger.LogError($"Server path not found or invalid: {serverPath}. Make sure that MCP Node.js server is installed.");
+                return;
+            }
+
+            string nodeModulesPath = Path.Combine(serverPath, "node_modules");
+            if (!Directory.Exists(nodeModulesPath))
+            {
+                McpUtils.RunNpmCommand("install", serverPath);
+            }
+
+            string buildPath = Path.Combine(serverPath, "build");
+            if (!Directory.Exists(buildPath))
+            {
+                McpUtils.RunNpmCommand("run build", serverPath);
+            }
+        }
 
         /// <summary>
         /// Register all available tools

Editor/UnityBridge/McpUnitySettings.cs

@@ -19,18 +19,15 @@ public class McpUnitySettings
 
         private const string EnvUnityPort = "UNITY_PORT";
         private const string EnvUnityRequestTimeout = "UNITY_REQUEST_TIMEOUT";
-        /// <remarks>
-        /// This file path is also read by the MCP server. Changes here will require updates to it. See mcpUnity.ts
-        /// </remarks>
         private const string SettingsPath = "ProjectSettings/McpUnitySettings.json";
 
         private static McpUnitySettings _instance;
 
-        // Server settings
-        public int Port { get; set; } = 8090;
+        [Tooltip("Port number for MCP server")]
+        public int Port = 8090;
 
         [Tooltip("Timeout in seconds for tool request")]
-        public int RequestTimeoutSeconds { get; set; } = RequestTimeoutMinimum;
+        public int RequestTimeoutSeconds = RequestTimeoutMinimum;
 
         [Tooltip("Whether to automatically start the MCP server when Unity opens")]
         public bool AutoStartServer = true;

Editor/Utils/McpConfigUtils.cs renamed to Editor/Utils/McpUtils.cs

@@ -12,7 +12,10 @@ namespace McpUnity.Utils
     /// <summary>
     /// Utility class for MCP configuration operations
     /// </summary>
-    public static class McpConfigUtils
+    /// <summary>
+    /// Utility class for MCP configuration and system operations
+    /// </summary>
+    public static class McpUtils
     {
         /// <summary>
         /// Generates the MCP configuration JSON to setup the Unity MCP server in different AI Clients
@@ -293,5 +296,72 @@ private static string GetCursorConfigPath()
             // Return the path to the mcp_config.json file
             return Path.Combine(basePath, "mcp.json");
         }
+
+        /// <summary>
+        /// Runs an npm command (such as install or build) in the specified working directory.
+        /// Handles cross-platform compatibility (Windows/macOS/Linux) for invoking npm.
+        /// Logs output and errors to the Unity console.
+        /// </summary>
+        /// <param name="arguments">Arguments to pass to npm (e.g., "install" or "run build").</param>
+        /// <param name="workingDirectory">The working directory where the npm command should be executed.</param>
+        public static void RunNpmCommand(string arguments, string workingDirectory)
+        {
+            string shellCommand = "/bin/bash";
+            string shellArguments = $"-c \"npm {arguments}\"";
+
+            if (Application.platform == RuntimePlatform.WindowsEditor)
+            {
+                shellCommand = "cmd.exe";
+                shellArguments = $"/c npm {arguments}";
+            }
+
+            System.Diagnostics.ProcessStartInfo startInfo = new System.Diagnostics.ProcessStartInfo
+            {
+                FileName = shellCommand,
+                Arguments = shellArguments,
+                WorkingDirectory = workingDirectory,
+                RedirectStandardOutput = true,
+                RedirectStandardError = true,
+                UseShellExecute = false,
+                CreateNoWindow = true
+            };
+
+            try
+            {
+                using (var process = System.Diagnostics.Process.Start(startInfo))
+                {
+                    if (process == null)
+                    {
+                        Debug.LogError($"[MCP Unity] Failed to start npm process with arguments: {arguments} in {workingDirectory}. Process object is null.");
+                        return;
+                    }
+
+                    string output = process.StandardOutput.ReadToEnd();
+                    string error = process.StandardError.ReadToEnd();
+
+                    process.WaitForExit();
+
+                    if (process.ExitCode == 0)
+                    {
+                        Debug.Log($"[MCP Unity] npm {arguments} completed successfully in {workingDirectory}.");
+                    }
+                    else
+                    {
+                        Debug.LogError($"[MCP Unity] npm {arguments} failed in {workingDirectory}. Exit Code: {process.ExitCode}");
+                    }
+                    
+                    if (!string.IsNullOrEmpty(output)) Debug.Log($"[MCP Unity] Output:\n{output}");
+                    if (!string.IsNullOrEmpty(error)) Debug.LogError($"[MCP Unity] Error:\n{error}");
+                }
+            }
+            catch (System.ComponentModel.Win32Exception ex) // Catch specific exception for "file not found"
+            {
+                Debug.LogError($"[MCP Unity] Failed to run npm command '{shellCommand} {shellArguments}'. Ensure Node.js and npm are installed and in your system's PATH. Error: {ex.Message}");
+            }
+            catch (Exception ex)
+            {
+                Debug.LogError($"[MCP Unity] Exception while running npm command '{shellCommand} {shellArguments}' in {workingDirectory}: {ex.Message}\nDetails: {ex.StackTrace}");
+            }
+        }
     }
 }