@akiojin/unity-mcp-server 2.40.2 → 2.40.3

package/src/handlers/gameobject/GameObjectGetHierarchyToolHandler.js

@@ -14,7 +14,8 @@ export class GameObjectGetHierarchyToolHandler extends BaseToolHandler {
         properties: {
           rootPath: {
             type: 'string',
-            description: 'Path to GameObject whose children will be the root of the returned hierarchy (e.g., "/Team_0" returns Team_0\'s children). If not specified, returns scene root objects.'
+            description:
+              'Path to GameObject whose children will be the root of the returned hierarchy (e.g., "/Team_0" returns Team_0\'s children). If not specified, returns scene root objects.'
           },
           includeInactive: {
             type: 'boolean',
@@ -22,16 +23,19 @@ export class GameObjectGetHierarchyToolHandler extends BaseToolHandler {
           },
           maxDepth: {
             type: 'number',
-            description: 'Maximum depth to traverse from the root. 0=immediate children only (default), 1=children+grandchildren, 2=children+grandchildren+great-grandchildren, etc. (-1 for unlimited)',
+            description:
+              'Maximum depth to traverse from the root. 0=immediate children only (default), 1=children+grandchildren, 2=children+grandchildren+great-grandchildren, etc. (-1 for unlimited)',
             minimum: -1
           },
           includeComponents: {
             type: 'boolean',
-            description: 'Include component information (default: false). WARNING: Significantly increases response size - use with small maxObjects values.'
+            description:
+              'Include component information (default: false). WARNING: Significantly increases response size - use with small maxObjects values.'
           },
           includeTransform: {
             type: 'boolean',
-            description: 'Include transform information (default: false). WARNING: Increases response size - use with small maxObjects values.'
+            description:
+              'Include transform information (default: false). WARNING: Increases response size - use with small maxObjects values.'
           },
           includeTags: {
             type: 'boolean',
@@ -43,18 +47,20 @@ export class GameObjectGetHierarchyToolHandler extends BaseToolHandler {
           },
           nameOnly: {
             type: 'boolean',
-            description: 'Return only names and paths for minimal data size (default: false). RECOMMENDED for large hierarchies to reduce token usage.'
+            description:
+              'Return only names and paths for minimal data size (default: false). RECOMMENDED for large hierarchies to reduce token usage.'
           },
           maxObjects: {
             type: 'number',
-            description: 'Maximum number of objects to include in response. Unity default: 100 (-1 for unlimited). RECOMMENDED: 10-50 for detailed info, 100-500 for nameOnly mode to avoid MCP token limits',
+            description:
+              'Maximum number of objects to include in response. Unity default: 100 (-1 for unlimited). RECOMMENDED: 10-50 for detailed info, 100-500 for nameOnly mode to avoid MCP token limits',
             minimum: -1
           }
         },
         required: []
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -65,7 +71,7 @@ export class GameObjectGetHierarchyToolHandler extends BaseToolHandler {
    */
   validate(params) {
     super.validate(params);
-    
+
     // Validate maxDepth
     if (params.maxDepth !== undefined) {
       const depth = Number(params.maxDepth);
@@ -73,7 +79,7 @@ export class GameObjectGetHierarchyToolHandler extends BaseToolHandler {
         throw new Error('maxDepth must be -1 or a positive number');
       }
     }
-    
+
     // Validate maxObjects
     if (params.maxObjects !== undefined) {
       const maxObjects = Number(params.maxObjects);
@@ -93,21 +99,21 @@ export class GameObjectGetHierarchyToolHandler extends BaseToolHandler {
     if (!this.unityConnection.isConnected()) {
       await this.unityConnection.connect();
     }
-    
+
     // Send get_hierarchy command
     const result = await this.unityConnection.sendCommand('get_hierarchy', params);
-    
+
     // Check for errors from Unity
     if (result.error) {
       throw new Error(result.error);
     }
-    
+
     // Add helpful summary
     if (result.hierarchy) {
       result.totalObjects = this.countObjects(result.hierarchy);
       result.summary = `Scene "${result.sceneName}" contains ${result.totalObjects} GameObject${result.totalObjects !== 1 ? 's' : ''} (${result.objectCount} at root level)`;
     }
-    
+
     return result;
   }
 
@@ -118,15 +124,15 @@ export class GameObjectGetHierarchyToolHandler extends BaseToolHandler {
    */
   countObjects(hierarchy) {
     let count = 0;
-    
+
     for (const node of hierarchy) {
       count++; // Count this node
-      
+
       if (node.children && Array.isArray(node.children)) {
         count += this.countObjects(node.children);
       }
     }
-    
+
     return count;
   }
 }

package/src/handlers/input/InputActionAddToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    addInputActionToolDefinition,
-    addInputActionHandler
+  addInputActionToolDefinition,
+  addInputActionHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputActionAddToolHandler extends BaseToolHandler {

package/src/handlers/input/InputActionMapCreateToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    createActionMapToolDefinition,
-    createActionMapHandler
+  createActionMapToolDefinition,
+  createActionMapHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputActionMapCreateToolHandler extends BaseToolHandler {

package/src/handlers/input/InputActionMapRemoveToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    removeActionMapToolDefinition,
-    removeActionMapHandler
+  removeActionMapToolDefinition,
+  removeActionMapHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputActionMapRemoveToolHandler extends BaseToolHandler {

package/src/handlers/input/InputActionRemoveToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    removeInputActionToolDefinition,
-    removeInputActionHandler
+  removeInputActionToolDefinition,
+  removeInputActionHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputActionRemoveToolHandler extends BaseToolHandler {

package/src/handlers/input/InputBindingAddToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    addInputBindingToolDefinition,
-    addInputBindingHandler
+  addInputBindingToolDefinition,
+  addInputBindingHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputBindingAddToolHandler extends BaseToolHandler {

package/src/handlers/input/InputBindingCompositeCreateToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    createCompositeBindingToolDefinition,
-    createCompositeBindingHandler
+  createCompositeBindingToolDefinition,
+  createCompositeBindingHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputBindingCompositeCreateToolHandler extends BaseToolHandler {

package/src/handlers/input/InputBindingRemoveAllToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    removeAllBindingsToolDefinition,
-    removeAllBindingsHandler
+  removeAllBindingsToolDefinition,
+  removeAllBindingsHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputBindingRemoveAllToolHandler extends BaseToolHandler {

package/src/handlers/input/InputBindingRemoveToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    removeInputBindingToolDefinition,
-    removeInputBindingHandler
+  removeInputBindingToolDefinition,
+  removeInputBindingHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputBindingRemoveToolHandler extends BaseToolHandler {

package/src/handlers/input/InputControlSchemesManageToolHandler.js

@@ -1,7 +1,7 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 import {
-    manageControlSchemesToolDefinition,
-    manageControlSchemesHandler
+  manageControlSchemesToolDefinition,
+  manageControlSchemesHandler
 } from '../../tools/input/inputActionsEditor.js';
 
 export class InputControlSchemesManageToolHandler extends BaseToolHandler {

package/src/handlers/package/PackageManagerToolHandler.js

@@ -7,50 +7,46 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
 
 export default class PackageManagerToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super(
-      'package_manage',
-      'Manage Unity packages - search, install, remove, and list packages',
-      {
-        type: 'object',
-        properties: {
-          action: {
-            type: 'string',
-            enum: ['search', 'list', 'install', 'remove', 'info', 'recommend'],
-            description: 'The package operation to perform'
-          },
-          keyword: {
-            type: 'string',
-            description: 'Search keyword (for search action)'
-          },
-          packageId: {
-            type: 'string',
-            description: 'Package ID to install (e.g., com.unity.textmeshpro)'
-          },
-          packageName: {
-            type: 'string',
-            description: 'Package name to remove or get info'
-          },
-          version: {
-            type: 'string',
-            description: 'Specific version to install (optional)'
-          },
-          category: {
-            type: 'string',
-            enum: ['essential', 'rendering', 'tools', 'networking', 'mobile'],
-            description: 'Category for recommendations'
-          },
-          includeBuiltIn: {
-            type: 'boolean',
-            description: 'Include built-in packages in list (default: false)'
-          },
-          limit: {
-            type: 'number',
-            description: 'Maximum number of search results (default: 20)'
-          }
+    super('package_manage', 'Manage Unity packages - search, install, remove, and list packages', {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['search', 'list', 'install', 'remove', 'info', 'recommend'],
+          description: 'The package operation to perform'
         },
-        required: ['action']
-      }
-    );
+        keyword: {
+          type: 'string',
+          description: 'Search keyword (for search action)'
+        },
+        packageId: {
+          type: 'string',
+          description: 'Package ID to install (e.g., com.unity.textmeshpro)'
+        },
+        packageName: {
+          type: 'string',
+          description: 'Package name to remove or get info'
+        },
+        version: {
+          type: 'string',
+          description: 'Specific version to install (optional)'
+        },
+        category: {
+          type: 'string',
+          enum: ['essential', 'rendering', 'tools', 'networking', 'mobile'],
+          description: 'Category for recommendations'
+        },
+        includeBuiltIn: {
+          type: 'boolean',
+          description: 'Include built-in packages in list (default: false)'
+        },
+        limit: {
+          type: 'number',
+          description: 'Maximum number of search results (default: 20)'
+        }
+      },
+      required: ['action']
+    });
     this.unityConnection = unityConnection;
   }
 
@@ -180,7 +176,8 @@ export default class PackageManagerToolHandler extends BaseToolHandler {
           packages: result.packages,
           allPackages: result.allPackages,
           message: result.message || 'Package recommendations retrieved'
-        };    }
+        };
+    }
   }
 
   truncateDescription(description) {

package/src/handlers/package/RegistryConfigToolHandler.js

@@ -61,7 +61,8 @@ export default class RegistryConfigToolHandler extends BaseToolHandler {
         if (!registryName) throw new Error('Registry name is required for remove action');
         break;
       case 'add_scope':
-        if (!registryName || !scope) throw new Error('Registry name and scope are required for add_scope action');
+        if (!registryName || !scope)
+          throw new Error('Registry name and scope are required for add_scope action');
         break;
     }
   }
@@ -180,18 +181,38 @@ export default class RegistryConfigToolHandler extends BaseToolHandler {
             scope: pkg.scope
           })),
           message: result.message || `Recommendations for ${result.registry}`
-        };    }
+        };
+    }
   }
 
   static getExamples() {
     return [
       { description: 'List configured registries', input: { action: 'list' } },
-      { description: 'Add OpenUPM registry with popular scopes', input: { action: 'add_openupm', autoAddPopular: true } },
-      { description: 'Add OpenUPM with custom scopes', input: { action: 'add_openupm', scopes: ['com.cysharp', 'com.neuecc', 'jp.keijiro'], autoAddPopular: false } },
-      { description: 'Add Unity NuGet registry', input: { action: 'add_nuget', autoAddPopular: true } },
-      { description: 'Add scope to existing registry', input: { action: 'add_scope', registryName: 'OpenUPM', scope: 'com.yasirkula' } },
+      {
+        description: 'Add OpenUPM registry with popular scopes',
+        input: { action: 'add_openupm', autoAddPopular: true }
+      },
+      {
+        description: 'Add OpenUPM with custom scopes',
+        input: {
+          action: 'add_openupm',
+          scopes: ['com.cysharp', 'com.neuecc', 'jp.keijiro'],
+          autoAddPopular: false
+        }
+      },
+      {
+        description: 'Add Unity NuGet registry',
+        input: { action: 'add_nuget', autoAddPopular: true }
+      },
+      {
+        description: 'Add scope to existing registry',
+        input: { action: 'add_scope', registryName: 'OpenUPM', scope: 'com.yasirkula' }
+      },
       { description: 'Remove a registry', input: { action: 'remove', registryName: 'OpenUPM' } },
-      { description: 'Get recommended packages for OpenUPM', input: { action: 'recommend', registry: 'openupm' } },
+      {
+        description: 'Get recommended packages for OpenUPM',
+        input: { action: 'recommend', registry: 'openupm' }
+      },
       { description: 'Get all registry recommendations', input: { action: 'recommend' } }
     ];
   }

package/src/handlers/playmode/PlaymodeGetStateToolHandler.js

@@ -5,23 +5,19 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
  */
 export class PlaymodeGetStateToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super(
-      'playmode_get_state',
-      'Get current Unity editor state including play mode status',
-      {
-        type: 'object',
-        properties: {
-          waitFor: {
-            type: 'object',
-            properties: { isPlaying: { type: 'boolean' } },
-            required: ['isPlaying']
-          },
-          timeoutMs: { type: 'number' },
-          pollMs: { type: 'number' }
+    super('playmode_get_state', 'Get current Unity editor state including play mode status', {
+      type: 'object',
+      properties: {
+        waitFor: {
+          type: 'object',
+          properties: { isPlaying: { type: 'boolean' } },
+          required: ['isPlaying']
         },
-        required: []
-      }
-    );
+        timeoutMs: { type: 'number' },
+        pollMs: { type: 'number' }
+      },
+      required: []
+    });
     this.unityConnection = unityConnection;
     // 軽量なソフトキャッシュ（単発取得時のみ使用）
     this._last = { t: 0, state: null };

package/src/handlers/playmode/PlaymodePauseToolHandler.js

@@ -5,15 +5,11 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
  */
 export class PlaymodePauseToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super(
-      'playmode_pause',
-      'Pause or resume Unity play mode',
-      {
-        type: 'object',
-        properties: {},
-        required: []
-      }
-    );
+    super('playmode_pause', 'Pause or resume Unity play mode', {
+      type: 'object',
+      properties: {},
+      required: []
+    });
     this.unityConnection = unityConnection;
   }
 
@@ -27,17 +23,17 @@ export class PlaymodePauseToolHandler extends BaseToolHandler {
     if (!this.unityConnection.isConnected()) {
       throw new Error('Unity connection not available');
     }
-    
+
     // Send pause command to Unity
     const result = await this.unityConnection.sendCommand('pause_game', params);
-    
+
     // Check for Unity-side errors
     if (result.status === 'error') {
       const error = new Error(result.error);
       error.code = 'UNITY_ERROR';
       throw error;
     }
-    
+
     // Return the result with state information
     return result;
   }

package/src/handlers/playmode/PlaymodeWaitForStateToolHandler.js

@@ -26,7 +26,9 @@ export class PlaymodeWaitForStateToolHandler extends BaseToolHandler {
     const start = Date.now();
     for (;;) {
       if (!this.unityConnection.isConnected()) {
-        try { await this.unityConnection.connect(); } catch {}
+        try {
+          await this.unityConnection.connect();
+        } catch {}
       }
       try {
         const state = await this.unityConnection.sendCommand('playmode_get_state', {});
@@ -36,10 +38,11 @@ export class PlaymodeWaitForStateToolHandler extends BaseToolHandler {
       } catch {}
       await new Promise(r => setTimeout(r, pollMs));
       if (timeoutMs != null && Date.now() - start > timeoutMs) {
-        const state = this.unityConnection.isConnected() ? await this.unityConnection.sendCommand('get_editor_state', {}).catch(() => ({})) : {};
+        const state = this.unityConnection.isConnected()
+          ? await this.unityConnection.sendCommand('get_editor_state', {}).catch(() => ({}))
+          : {};
         return { status: 'timeout', state, waitedMs: Date.now() - start };
       }
     }
   }
 }
-

package/src/handlers/scene/GetSceneInfoToolHandler.js

@@ -5,16 +5,16 @@ import { getSceneInfoToolDefinition, getSceneInfoHandler } from '../../tools/sce
  * Handler for get_scene_info tool
  */
 export class GetSceneInfoToolHandler extends BaseToolHandler {
-    constructor(unityConnection) {
-        super(
-            getSceneInfoToolDefinition.name,
-            getSceneInfoToolDefinition.description,
-            getSceneInfoToolDefinition.inputSchema
-        );
-        this.unityConnection = unityConnection;
-    }
+  constructor(unityConnection) {
+    super(
+      getSceneInfoToolDefinition.name,
+      getSceneInfoToolDefinition.description,
+      getSceneInfoToolDefinition.inputSchema
+    );
+    this.unityConnection = unityConnection;
+  }
 
-    async execute(args) {
-        return getSceneInfoHandler(this.unityConnection, args);
-    }
+  async execute(args) {
+    return getSceneInfoHandler(this.unityConnection, args);
+  }
 }

package/src/handlers/scene/SceneCreateToolHandler.js

@@ -5,32 +5,29 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
  */
 export class SceneCreateToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super(
-      'scene_create',
-      'Create a new scene (optionally load it and add to build settings).',
-      {
-        type: 'object',
-        properties: {
-          sceneName: {
-            type: 'string',
-            description: 'Name of the scene to create'
-          },
-          path: {
-            type: 'string',
-            description: 'Path where the scene should be saved (e.g., "Assets/Scenes/"). If not specified, defaults to "Assets/Scenes/"'
-          },
-          loadScene: {
-            type: 'boolean',
-            description: 'Whether to load the scene after creation (default: true)'
-          },
-          addToBuildSettings: {
-            type: 'boolean',
-            description: 'Whether to add the scene to build settings (default: false)'
-          }
+    super('scene_create', 'Create a new scene (optionally load it and add to build settings).', {
+      type: 'object',
+      properties: {
+        sceneName: {
+          type: 'string',
+          description: 'Name of the scene to create'
         },
-        required: ['sceneName']
-      }
-    );
+        path: {
+          type: 'string',
+          description:
+            'Path where the scene should be saved (e.g., "Assets/Scenes/"). If not specified, defaults to "Assets/Scenes/"'
+        },
+        loadScene: {
+          type: 'boolean',
+          description: 'Whether to load the scene after creation (default: true)'
+        },
+        addToBuildSettings: {
+          type: 'boolean',
+          description: 'Whether to add the scene to build settings (default: false)'
+        }
+      },
+      required: ['sceneName']
+    });
     this.unityConnection = unityConnection;
   }
 
@@ -41,12 +38,12 @@ export class SceneCreateToolHandler extends BaseToolHandler {
    */
   validate(params) {
     super.validate(params);
-    
+
     // Additional validation for scene name
     if (!params.sceneName || params.sceneName.trim() === '') {
       throw new Error('Scene name cannot be empty');
     }
-    
+
     // Check for invalid characters in scene name
     if (params.sceneName.includes('/') || params.sceneName.includes('\\')) {
       throw new Error('Scene name contains invalid characters');
@@ -63,17 +60,17 @@ export class SceneCreateToolHandler extends BaseToolHandler {
     if (!this.unityConnection.isConnected()) {
       throw new Error('Unity connection not available');
     }
-    
+
     // Send command to Unity
     const result = await this.unityConnection.sendCommand('create_scene', params);
-    
+
     // Check for Unity-side errors
     if (result.status === 'error') {
       const error = new Error(result.error);
       error.code = 'UNITY_ERROR';
       throw error;
     }
-    
+
     // Handle undefined or null results from Unity
     if (result.result === undefined || result.result === null) {
       return {
@@ -85,7 +82,7 @@ export class SceneCreateToolHandler extends BaseToolHandler {
         message: 'Scene creation completed but Unity returned no details'
       };
     }
-    
+
     return result.result;
   }
 }