@akiojin/unity-mcp-server 4.2.0 → 5.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akiojin/unity-mcp-server",
-  "version": "4.2.0",
+  "version": "5.0.0",
   "description": "MCP server and Unity Editor bridge — enables AI assistants to control Unity for AI-assisted workflows",
   "type": "module",
   "main": "src/core/server.js",

package/src/core/config.js

@@ -153,7 +153,7 @@ const baseConfig = {
 
   // LSP client defaults
   lsp: {
-    requestTimeoutMs: 60000
+    requestTimeoutMs: 120000
   },
 
   // Indexing (code index) settings

package/src/core/unityConnection.js

@@ -649,10 +649,9 @@ function wrapUnityConnectError(error, host, port) {
 }
 
 function buildUnityConnectionHint(_host, _port) {
-  const configPath = config.__configPath || '.unity/config.json';
   return (
     `Start Unity Editor and ensure the Unity MCP package is running (TCP listener). ` +
-    `Check ${configPath} (unity.mcpHost/unity.port). ` +
-    `If using WSL2/Docker → Windows Unity, set unity.mcpHost=host.docker.internal.`
+    `Check UNITY_MCP_MCP_HOST / UNITY_MCP_PORT and Unity Project Settings (Host/Port). ` +
+    `If using WSL2/Docker → Windows Unity, set UNITY_MCP_MCP_HOST=host.docker.internal.`
   );
 }

package/src/handlers/addressables/AddressablesAnalyzeToolHandler.js

@@ -7,7 +7,7 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
 export default class AddressablesAnalyzeToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'addressables_analyze',
+      'analyze_addressables',
       'Analyze Unity Addressables for duplicates, dependencies, and unused assets',
       {
         type: 'object',
@@ -68,7 +68,7 @@ export default class AddressablesAnalyzeToolHandler extends BaseToolHandler {
       await this.unityConnection.connect();
     }
 
-    const result = await this.unityConnection.sendCommand('addressables_analyze', {
+    const result = await this.unityConnection.sendCommand('analyze_addressables', {
       action,
       ...parameters
     });

package/src/handlers/addressables/AddressablesBuildToolHandler.js

@@ -6,7 +6,7 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
  */
 export default class AddressablesBuildToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super('addressables_build', 'Build Unity Addressables content or clean build cache', {
+    super('build_addressables', 'Build Unity Addressables content or clean build cache', {
       type: 'object',
       properties: {
         action: {
@@ -75,7 +75,7 @@ export default class AddressablesBuildToolHandler extends BaseToolHandler {
     const timeout = 300000; // 5 minutes
 
     const result = await this.unityConnection.sendCommand(
-      'addressables_build',
+      'build_addressables',
       {
         action,
         ...parameters

package/src/handlers/addressables/AddressablesManageToolHandler.js

@@ -7,7 +7,7 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
 export default class AddressablesManageToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
     super(
-      'addressables_manage',
+      'manage_addressables',
       'Manage Unity Addressables assets and groups - add, remove, organize entries and groups',
       {
         type: 'object',
@@ -141,7 +141,7 @@ export default class AddressablesManageToolHandler extends BaseToolHandler {
       await this.unityConnection.connect();
     }
 
-    const result = await this.unityConnection.sendCommand('addressables_manage', {
+    const result = await this.unityConnection.sendCommand('manage_addressables', {
       action,
       ...parameters
     });

package/src/handlers/input/InputSystemControlToolHandler.js

@@ -5,7 +5,7 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
  */
 export class InputSystemControlToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super('input_system_control', 'Main handler for Input System operations', {
+    super('control_input_system', 'Main handler for Input System operations', {
       type: 'object',
       properties: {
         operation: {

package/src/handlers/input/InputTouchToolHandler.js

@@ -127,7 +127,7 @@ function validateTouchAction(params, context = 'action') {
  */
 export class InputTouchToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super('input_touch', 'Touch input (tap/swipe/pinch/multi) with batching.', {
+    super('simulate_touch', 'Touch input (tap/swipe/pinch/multi) with batching.', {
       type: 'object',
       properties: {
         ...actionProperties,
@@ -181,7 +181,7 @@ export class InputTouchToolHandler extends BaseToolHandler {
     const hasBatch = Array.isArray(params.actions) && params.actions.length > 0;
     const payload = hasBatch ? { actions: params.actions } : params;
 
-    const result = await this.unityConnection.sendCommand('input_touch', payload);
+    const result = await this.unityConnection.sendCommand('simulate_touch', payload);
     return result;
   }
 }

package/src/handlers/package/PackageManagerToolHandler.js

@@ -7,7 +7,7 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
 
 export default class PackageManagerToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super('package_manager', 'Manage Unity packages - search, install, remove, and list packages', {
+    super('manage_packages', 'Manage Unity packages - search, install, remove, and list packages', {
       type: 'object',
       properties: {
         action: {
@@ -84,7 +84,7 @@ export default class PackageManagerToolHandler extends BaseToolHandler {
       await this.unityConnection.connect();
     }
 
-    const result = await this.unityConnection.sendCommand('package_managerr', {
+    const result = await this.unityConnection.sendCommand('manage_packages', {
       action,
       ...parameters
     });

package/src/handlers/script/ScriptEditSnippetToolHandler.js

@@ -30,6 +30,11 @@ export class ScriptEditSnippetToolHandler extends BaseToolHandler {
             description:
               'If true, run validation and return preview text without writing to disk. Default=false.'
           },
+          skipValidation: {
+            type: 'boolean',
+            description:
+              'If true, skip LSP validation for faster execution. Lightweight syntax checks (brace balance) are still performed. Use for simple edits on large files. Default=false.'
+          },
           instructions: {
             type: 'array',
             minItems: 1,
@@ -114,6 +119,7 @@ export class ScriptEditSnippetToolHandler extends BaseToolHandler {
     const info = await this.projectInfo.get();
     const { relative, absolute } = this.#resolvePaths(info, params.path);
     const preview = params.preview === true;
+    const skipValidation = params.skipValidation === true;
     const instructions = params.instructions;
 
     let original;
@@ -142,7 +148,13 @@ export class ScriptEditSnippetToolHandler extends BaseToolHandler {
     }
 
     if (working === original) {
-      return this.#buildResponse({ preview, results, original, updated: working });
+      return this.#buildResponse({
+        preview,
+        results,
+        original,
+        updated: working,
+        validationSkipped: skipValidation
+      });
     }
 
     // Pre-syntax check on edited content before LSP validation
@@ -154,19 +166,30 @@ export class ScriptEditSnippetToolHandler extends BaseToolHandler {
       );
     }
 
-    const diagnostics = await this.#validateWithLsp(info, relative, working);
-    const hasErrors = diagnostics.some(d => this.#severityIsError(d.severity));
-    if (hasErrors) {
-      const first = diagnostics.find(d => this.#severityIsError(d.severity));
-      const msg = first?.message || 'syntax error';
-      throw new Error(`syntax_error: ${msg}`);
+    // LSP validation (skip if skipValidation=true for large files)
+    let diagnostics = [];
+    if (!skipValidation) {
+      diagnostics = await this.#validateWithLsp(info, relative, working);
+      const hasErrors = diagnostics.some(d => this.#severityIsError(d.severity));
+      if (hasErrors) {
+        const first = diagnostics.find(d => this.#severityIsError(d.severity));
+        const msg = first?.message || 'syntax error';
+        throw new Error(`syntax_error: ${msg}`);
+      }
     }
 
     if (!preview) {
       await fs.writeFile(absolute, working, 'utf8');
     }
 
-    return this.#buildResponse({ preview, results, original, updated: working, diagnostics });
+    return this.#buildResponse({
+      preview,
+      results,
+      original,
+      updated: working,
+      diagnostics,
+      validationSkipped: skipValidation
+    });
   }
 
   #resolvePaths(info, rawPath) {
@@ -279,12 +302,20 @@ export class ScriptEditSnippetToolHandler extends BaseToolHandler {
     return await this.lsp.validateText(relative, updatedText);
   }
 
-  #buildResponse({ preview, results, original, updated, diagnostics = [] }) {
+  #buildResponse({
+    preview,
+    results,
+    original,
+    updated,
+    diagnostics = [],
+    validationSkipped = false
+  }) {
     const out = {
       success: true,
       applied: !preview,
       results,
       diagnostics,
+      validationSkipped,
       beforeHash: this.#hash(original),
       afterHash: this.#hash(updated)
     };