@akiojin/unity-mcp-server 2.40.2 → 2.40.3

package/src/handlers/asset/AssetPrefabInstantiateToolHandler.js

@@ -1,133 +1,127 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 
 export class AssetPrefabInstantiateToolHandler extends BaseToolHandler {
-    constructor(unityConnection) {
-        super(
-            'asset_prefab_instantiate',
-            'Instantiate a prefab in the scene with optional transform, parent, and name override.',
-            {
-                type: 'object',
-                properties: {
-                    prefabPath: {
-                        type: 'string',
-                        description: 'Asset path to the prefab. Must start with Assets/ and end with .prefab.'
-                    },
-                    position: {
-                        type: 'object',
-                        properties: {
-                            x: { type: 'number' },
-                            y: { type: 'number' },
-                            z: { type: 'number' }
-                        },
-                        description: 'World position for the instance (requires x,y,z).'
-                    },
-                    rotation: {
-                        type: 'object',
-                        properties: {
-                            x: { type: 'number' },
-                            y: { type: 'number' },
-                            z: { type: 'number' }
-                        },
-                        description: 'Euler rotation for the instance (x,y,z).'
-                    },
-                    parent: {
-                        type: 'string',
-                        description: 'Parent GameObject scene path (optional).'
-                    },
-                    name: {
-                        type: 'string',
-                        description: 'Override name for the instantiated object.'
-                    }
-                },
-                required: ['prefabPath']
-            }
-        );
-        this.unityConnection = unityConnection;
-    }
+  constructor(unityConnection) {
+    super(
+      'asset_prefab_instantiate',
+      'Instantiate a prefab in the scene with optional transform, parent, and name override.',
+      {
+        type: 'object',
+        properties: {
+          prefabPath: {
+            type: 'string',
+            description: 'Asset path to the prefab. Must start with Assets/ and end with .prefab.'
+          },
+          position: {
+            type: 'object',
+            properties: {
+              x: { type: 'number' },
+              y: { type: 'number' },
+              z: { type: 'number' }
+            },
+            description: 'World position for the instance (requires x,y,z).'
+          },
+          rotation: {
+            type: 'object',
+            properties: {
+              x: { type: 'number' },
+              y: { type: 'number' },
+              z: { type: 'number' }
+            },
+            description: 'Euler rotation for the instance (x,y,z).'
+          },
+          parent: {
+            type: 'string',
+            description: 'Parent GameObject scene path (optional).'
+          },
+          name: {
+            type: 'string',
+            description: 'Override name for the instantiated object.'
+          }
+        },
+        required: ['prefabPath']
+      }
+    );
+    this.unityConnection = unityConnection;
+  }
 
-    validate(params) {
-        // Call parent validation for required fields
-        super.validate(params);
+  validate(params) {
+    // Call parent validation for required fields
+    super.validate(params);
 
-        const { prefabPath, parent, position, rotation } = params;
+    const { prefabPath, parent, position, rotation } = params;
 
-        // Validate prefabPath format
-        if (!prefabPath.startsWith('Assets/') || !prefabPath.endsWith('.prefab')) {
-            throw new Error('prefabPath must start with Assets/ and end with .prefab');
-        }
+    // Validate prefabPath format
+    if (!prefabPath.startsWith('Assets/') || !prefabPath.endsWith('.prefab')) {
+      throw new Error('prefabPath must start with Assets/ and end with .prefab');
+    }
 
-        // Validate parent when provided
-        if (parent !== undefined && parent === '') {
-            throw new Error('parent cannot be empty when provided');
-        }
+    // Validate parent when provided
+    if (parent !== undefined && parent === '') {
+      throw new Error('parent cannot be empty when provided');
+    }
 
-        // Validate position object when provided
-        if (position !== undefined) {
-            if (typeof position !== 'object' || position === null) {
-                throw new Error('position must be an object');
-            }
-            
-            // Check individual properties first for better error messages
-            if ('x' in position && typeof position.x !== 'number') {
-                throw new Error('position.x must be a number');
-            }
-            if ('y' in position && typeof position.y !== 'number') {
-                throw new Error('position.y must be a number');
-            }
-            if ('z' in position && typeof position.z !== 'number') {
-                throw new Error('position.z must be a number');
-            }
-            
-            // Then check for missing properties
-            if (!('x' in position) || !('y' in position) || !('z' in position)) {
-                throw new Error('position must have x, y, and z properties');
-            }
-        }
+    // Validate position object when provided
+    if (position !== undefined) {
+      if (typeof position !== 'object' || position === null) {
+        throw new Error('position must be an object');
+      }
 
-        // Validate rotation object when provided
-        if (rotation !== undefined) {
-            if (typeof rotation !== 'object' || rotation === null) {
-                throw new Error('rotation must be an object');
-            }
-            
-            if (!('x' in rotation) || !('y' in rotation) || !('z' in rotation)) {
-                throw new Error('rotation must have x, y, and z properties');
-            }
+      // Check individual properties first for better error messages
+      if ('x' in position && typeof position.x !== 'number') {
+        throw new Error('position.x must be a number');
+      }
+      if ('y' in position && typeof position.y !== 'number') {
+        throw new Error('position.y must be a number');
+      }
+      if ('z' in position && typeof position.z !== 'number') {
+        throw new Error('position.z must be a number');
+      }
 
-            if (typeof rotation.x !== 'number') {
-                throw new Error('rotation.x must be a number');
-            }
-            if (typeof rotation.y !== 'number') {
-                throw new Error('rotation.y must be a number');
-            }
-            if (typeof rotation.z !== 'number') {
-                throw new Error('rotation.z must be a number');
-            }
-        }
+      // Then check for missing properties
+      if (!('x' in position) || !('y' in position) || !('z' in position)) {
+        throw new Error('position must have x, y, and z properties');
+      }
     }
 
-    async execute(params) {
-        const {
-            prefabPath,
-            position,
-            rotation,
-            parent,
-            name
-        } = params;
+    // Validate rotation object when provided
+    if (rotation !== undefined) {
+      if (typeof rotation !== 'object' || rotation === null) {
+        throw new Error('rotation must be an object');
+      }
 
-        // Ensure connected
-        if (!this.unityConnection.isConnected()) {
-            await this.unityConnection.connect();
-        }
+      if (!('x' in rotation) || !('y' in rotation) || !('z' in rotation)) {
+        throw new Error('rotation must have x, y, and z properties');
+      }
 
-        const result = await this.unityConnection.sendCommand('instantiate_prefab', {
-            prefabPath,
-            position,
-            rotation,
-            parent,
-            name
-        });
+      if (typeof rotation.x !== 'number') {
+        throw new Error('rotation.x must be a number');
+      }
+      if (typeof rotation.y !== 'number') {
+        throw new Error('rotation.y must be a number');
+      }
+      if (typeof rotation.z !== 'number') {
+        throw new Error('rotation.z must be a number');
+      }
+    }
+  }
 
-        return result;
+  async execute(params) {
+    const { prefabPath, position, rotation, parent, name } = params;
+
+    // Ensure connected
+    if (!this.unityConnection.isConnected()) {
+      await this.unityConnection.connect();
     }
+
+    const result = await this.unityConnection.sendCommand('instantiate_prefab', {
+      prefabPath,
+      position,
+      rotation,
+      parent,
+      name
+    });
+
+    return result;
+  }
 }

package/src/handlers/asset/AssetPrefabModifyToolHandler.js

@@ -1,72 +1,72 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
 
 export class AssetPrefabModifyToolHandler extends BaseToolHandler {
-    constructor(unityConnection) {
-        super(
-            'asset_prefab_modify',
-            'Modify an existing prefab by applying property changes (optionally to instances).',
-            {
-                type: 'object',
-                properties: {
-                    prefabPath: {
-                        type: 'string',
-                        description: 'Asset path to the prefab. Must start with Assets/ and end with .prefab.'
-                    },
-                    modifications: {
-                        type: 'object',
-                        description: 'Key/value object of properties to modify on the prefab.'
-                    },
-                    applyToInstances: {
-                        type: 'boolean',
-                        description: 'If true, also apply to existing scene instances (default: true).'
-                    }
-                },
-                required: ['prefabPath', 'modifications']
-            }
-        );
-        this.unityConnection = unityConnection;
-    }
+  constructor(unityConnection) {
+    super(
+      'asset_prefab_modify',
+      'Modify an existing prefab by applying property changes (optionally to instances).',
+      {
+        type: 'object',
+        properties: {
+          prefabPath: {
+            type: 'string',
+            description: 'Asset path to the prefab. Must start with Assets/ and end with .prefab.'
+          },
+          modifications: {
+            type: 'object',
+            description: 'Key/value object of properties to modify on the prefab.'
+          },
+          applyToInstances: {
+            type: 'boolean',
+            description: 'If true, also apply to existing scene instances (default: true).'
+          }
+        },
+        required: ['prefabPath', 'modifications']
+      }
+    );
+    this.unityConnection = unityConnection;
+  }
 
-    validate(params) {
-        // Call parent validation for required fields
-        super.validate(params);
+  validate(params) {
+    // Call parent validation for required fields
+    super.validate(params);
 
-        const { prefabPath, modifications } = params;
+    const { prefabPath, modifications } = params;
 
-        // Validate prefabPath format
-        if (!prefabPath.startsWith('Assets/') || !prefabPath.endsWith('.prefab')) {
-            throw new Error('prefabPath must start with Assets/ and end with .prefab');
-        }
+    // Validate prefabPath format
+    if (!prefabPath.startsWith('Assets/') || !prefabPath.endsWith('.prefab')) {
+      throw new Error('prefabPath must start with Assets/ and end with .prefab');
+    }
 
-        // Validate modifications is object
-        if (typeof modifications !== 'object' || modifications === null || Array.isArray(modifications)) {
-            throw new Error('modifications must be an object');
-        }
+    // Validate modifications is object
+    if (
+      typeof modifications !== 'object' ||
+      modifications === null ||
+      Array.isArray(modifications)
+    ) {
+      throw new Error('modifications must be an object');
+    }
 
-        // Validate modifications is not empty
-        if (Object.keys(modifications).length === 0) {
-            throw new Error('modifications cannot be empty');
-        }
+    // Validate modifications is not empty
+    if (Object.keys(modifications).length === 0) {
+      throw new Error('modifications cannot be empty');
     }
+  }
 
-    async execute(params) {
-        const {
-            prefabPath,
-            modifications,
-            applyToInstances = true
-        } = params;
+  async execute(params) {
+    const { prefabPath, modifications, applyToInstances = true } = params;
 
-        // Ensure connected
-        if (!this.unityConnection.isConnected()) {
-            await this.unityConnection.connect();
-        }
+    // Ensure connected
+    if (!this.unityConnection.isConnected()) {
+      await this.unityConnection.connect();
+    }
 
-        const result = await this.unityConnection.sendCommand('modify_prefab', {
-            prefabPath,
-            modifications,
-            applyToInstances
-        });
+    const result = await this.unityConnection.sendCommand('modify_prefab', {
+      prefabPath,
+      modifications,
+      applyToInstances
+    });
 
-        return result;
-    }
+    return result;
+  }
 }

package/src/handlers/asset/AssetPrefabOpenToolHandler.js

@@ -17,7 +17,8 @@ export class AssetPrefabOpenToolHandler extends BaseToolHandler {
           },
           focusObject: {
             type: 'string',
-            description: 'Optional path to object within prefab to focus on (relative to prefab root)'
+            description:
+              'Optional path to object within prefab to focus on (relative to prefab root)'
           },
           isolateObject: {
             type: 'boolean',
@@ -27,7 +28,7 @@ export class AssetPrefabOpenToolHandler extends BaseToolHandler {
         required: ['prefabPath']
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -38,7 +39,7 @@ export class AssetPrefabOpenToolHandler extends BaseToolHandler {
    */
   validate(params) {
     super.validate(params); // Check required fields
-    
+
     const { prefabPath } = params;
 
     // Validate prefabPath is not empty
@@ -111,11 +112,12 @@ export class AssetPrefabOpenToolHandler extends BaseToolHandler {
         }
       },
       openForComponentWork: {
-        description: 'Open prefab for component inspection and modification (use with component tools like list_components, add_component, etc.)',
+        description:
+          'Open prefab for component inspection and modification (use with component tools like list_components, add_component, etc.)',
         params: {
           prefabPath: 'Assets/Prefabs/Weapons/Sword.prefab'
         }
       }
     };
   }
-}
+}

package/src/handlers/asset/AssetPrefabSaveToolHandler.js

@@ -13,7 +13,8 @@ export class AssetPrefabSaveToolHandler extends BaseToolHandler {
         properties: {
           gameObjectPath: {
             type: 'string',
-            description: 'Path to GameObject to save as prefab override (optional - if not provided, saves current prefab in prefab mode)'
+            description:
+              'Path to GameObject to save as prefab override (optional - if not provided, saves current prefab in prefab mode)'
           },
           includeChildren: {
             type: 'boolean',
@@ -22,7 +23,7 @@ export class AssetPrefabSaveToolHandler extends BaseToolHandler {
         }
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -63,11 +64,17 @@ export class AssetPrefabSaveToolHandler extends BaseToolHandler {
     return {
       success: response.success,
       message: response.message || 'Prefab saved',
-      ...(response.savedInPrefabMode !== undefined && { savedInPrefabMode: response.savedInPrefabMode }),
+      ...(response.savedInPrefabMode !== undefined && {
+        savedInPrefabMode: response.savedInPrefabMode
+      }),
       ...(response.prefabPath !== undefined && { prefabPath: response.prefabPath }),
       ...(response.gameObjectPath !== undefined && { gameObjectPath: response.gameObjectPath }),
-      ...(response.overridesApplied !== undefined && { overridesApplied: response.overridesApplied }),
-      ...(response.includedChildren !== undefined && { includedChildren: response.includedChildren })
+      ...(response.overridesApplied !== undefined && {
+        overridesApplied: response.overridesApplied
+      }),
+      ...(response.includedChildren !== undefined && {
+        includedChildren: response.includedChildren
+      })
     };
   }
 
@@ -103,4 +110,4 @@ export class AssetPrefabSaveToolHandler extends BaseToolHandler {
       }
     };
   }
-}
+}

package/src/handlers/compilation/CompilationGetStateToolHandler.js

@@ -13,7 +13,8 @@ export class CompilationGetStateToolHandler extends BaseToolHandler {
         properties: {
           includeMessages: {
             type: 'boolean',
-            description: 'Include detailed compilation messages. Unity default: false. Set to true for debugging compilation issues'
+            description:
+              'Include detailed compilation messages. Unity default: false. Set to true for debugging compilation issues'
           },
           maxMessages: {
             type: 'number',
@@ -22,7 +23,7 @@ export class CompilationGetStateToolHandler extends BaseToolHandler {
         }
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -87,4 +88,4 @@ export class CompilationGetStateToolHandler extends BaseToolHandler {
       }
     };
   }
-}
+}

package/src/handlers/component/ComponentAddToolHandler.js

@@ -28,7 +28,7 @@ export class ComponentAddToolHandler extends BaseToolHandler {
         required: ['gameObjectPath', 'componentType']
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -39,7 +39,7 @@ export class ComponentAddToolHandler extends BaseToolHandler {
    */
   validate(params) {
     super.validate(params); // Check required fields
-    
+
     const { gameObjectPath, componentType } = params;
 
     if (!gameObjectPath || gameObjectPath.trim() === '') {

package/src/handlers/component/ComponentGetTypesToolHandler.js

@@ -5,28 +5,24 @@ import { BaseToolHandler } from '../base/BaseToolHandler.js';
  */
 export class ComponentGetTypesToolHandler extends BaseToolHandler {
   constructor(unityConnection) {
-    super(
-      'component_get_types',
-      'Get available component types in Unity',
-      {
-        type: 'object',
-        properties: {
-          category: {
-            type: 'string',
-            description: 'Filter by category (e.g., "Physics", "Rendering", "UI")'
-          },
-          search: {
-            type: 'string',
-            description: 'Search for component types by name'
-          },
-          onlyAddable: {
-            type: 'boolean',
-            description: 'Return only components that can be added to GameObjects (default: false)'
-          }
+    super('component_get_types', 'Get available component types in Unity', {
+      type: 'object',
+      properties: {
+        category: {
+          type: 'string',
+          description: 'Filter by category (e.g., "Physics", "Rendering", "UI")'
+        },
+        search: {
+          type: 'string',
+          description: 'Search for component types by name'
+        },
+        onlyAddable: {
+          type: 'boolean',
+          description: 'Return only components that can be added to GameObjects (default: false)'
         }
       }
-    );
-    
+    });
+
     this.unityConnection = unityConnection;
   }
 
@@ -97,4 +93,4 @@ export class ComponentGetTypesToolHandler extends BaseToolHandler {
       }
     };
   }
-}
+}

package/src/handlers/component/ComponentListToolHandler.js

@@ -23,7 +23,7 @@ export class ComponentListToolHandler extends BaseToolHandler {
         required: ['gameObjectPath']
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -51,7 +51,9 @@ export class ComponentListToolHandler extends BaseToolHandler {
       gameObjectPath: response.gameObjectPath,
       components: response.components || [],
       componentCount: response.componentCount || 0,
-      ...(response.includesInherited !== undefined && { includesInherited: response.includesInherited })
+      ...(response.includesInherited !== undefined && {
+        includesInherited: response.includesInherited
+      })
     };
   }
 
@@ -82,4 +84,4 @@ export class ComponentListToolHandler extends BaseToolHandler {
       }
     };
   }
-}
+}

package/src/handlers/component/ComponentModifyToolHandler.js

@@ -32,7 +32,7 @@ export class ComponentModifyToolHandler extends BaseToolHandler {
         required: ['gameObjectPath', 'componentType', 'properties']
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -43,7 +43,7 @@ export class ComponentModifyToolHandler extends BaseToolHandler {
    */
   validate(params) {
     super.validate(params); // Check required fields
-    
+
     const { properties } = params;
 
     // Validate properties is not empty
@@ -140,4 +140,4 @@ export class ComponentModifyToolHandler extends BaseToolHandler {
       }
     };
   }
-}
+}

package/src/handlers/component/ComponentRemoveToolHandler.js

@@ -27,7 +27,7 @@ export class ComponentRemoveToolHandler extends BaseToolHandler {
         required: ['gameObjectPath', 'componentType']
       }
     );
-    
+
     this.unityConnection = unityConnection;
   }
 
@@ -38,7 +38,7 @@ export class ComponentRemoveToolHandler extends BaseToolHandler {
    */
   validate(params) {
     super.validate(params); // Check required fields
-    
+
     const { componentIndex } = params;
 
     // Validate component index if provided