@akiojin/unity-mcp-server 2.40.2 → 2.40.3

package/src/tools/analysis/getComponentValues.js

@@ -2,181 +2,181 @@
  * Tool definition for analysis_component_values_get
  */
 export const getComponentValuesToolDefinition = {
-    name: 'analysis_component_values_get',
-    description: 'Get properties/values from a component on a GameObject (scene or prefab mode).',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            gameObjectName: {
-                type: 'string',
-                description: 'Name of the GameObject'
-            },
-            componentType: {
-                type: 'string',
-                description: 'Type of component (e.g., "Light", "Camera", "Rigidbody")'
-            },
-            componentIndex: {
-                type: 'number',
-                description: 'Index if multiple components of same type. Default: 0'
-            },
-            includePrivateFields: {
-                type: 'boolean',
-                description: 'Include non-public fields. Default: false'
-            },
-            includeInherited: {
-                type: 'boolean',
-                description: 'Include inherited properties. Default: true'
-            }
-        },
-        required: ['gameObjectName', 'componentType']
-    }
+  name: 'analysis_component_values_get',
+  description: 'Get properties/values from a component on a GameObject (scene or prefab mode).',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      gameObjectName: {
+        type: 'string',
+        description: 'Name of the GameObject'
+      },
+      componentType: {
+        type: 'string',
+        description: 'Type of component (e.g., "Light", "Camera", "Rigidbody")'
+      },
+      componentIndex: {
+        type: 'number',
+        description: 'Index if multiple components of same type. Default: 0'
+      },
+      includePrivateFields: {
+        type: 'boolean',
+        description: 'Include non-public fields. Default: false'
+      },
+      includeInherited: {
+        type: 'boolean',
+        description: 'Include inherited properties. Default: true'
+      }
+    },
+    required: ['gameObjectName', 'componentType']
+  }
 };
 
 /**
  * Handler for get_component_values tool
  */
 export async function getComponentValuesHandler(unityConnection, args) {
-    try {
-        // Check connection
-        if (!unityConnection.isConnected()) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Failed to get component values: Unity connection not available'
-                    }
-                ],
-                isError: true
-            };
-        }
+  try {
+    // Check connection
+    if (!unityConnection.isConnected()) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'Failed to get component values: Unity connection not available'
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Validate required parameters
-        if (!args.componentType) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Failed to get component values: componentType is required'
-                    }
-                ],
-                isError: true
-            };
-        }
+    // Validate required parameters
+    if (!args.componentType) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'Failed to get component values: componentType is required'
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Validate componentIndex if provided
-        if (args.componentIndex !== undefined && args.componentIndex < 0) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Failed to get component values: componentIndex must be non-negative'
-                    }
-                ],
-                isError: true
-            };
-        }
+    // Validate componentIndex if provided
+    if (args.componentIndex !== undefined && args.componentIndex < 0) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'Failed to get component values: componentIndex must be non-negative'
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Send command to Unity
-        const result = await unityConnection.sendCommand('analysis_component_values_get', args);
+    // Send command to Unity
+    const result = await unityConnection.sendCommand('analysis_component_values_get', args);
 
-        // The unityConnection.sendCommand already extracts the result field
-        // from the response, so we access properties directly on result
-        if (!result || typeof result === 'string') {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Failed to get component values: Invalid response format`
-                    }
-                ],
-                isError: true
-            };
-        }
+    // The unityConnection.sendCommand already extracts the result field
+    // from the response, so we access properties directly on result
+    if (!result || typeof result === 'string') {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Failed to get component values: Invalid response format`
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Check if result has error property (error response from Unity)
-        if (result.error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Failed to get component values: ${result.error}`
-                    }
-                ],
-                isError: true
-            };
-        }
+    // Check if result has error property (error response from Unity)
+    if (result.error) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Failed to get component values: ${result.error}`
+          }
+        ],
+        isError: true
+      };
+    }
+
+    // Success response - result is already the unwrapped data
+    console.log('[DEBUG] GetComponentValues - Full result:', JSON.stringify(result, null, 2));
 
-        // Success response - result is already the unwrapped data
-        console.log('[DEBUG] GetComponentValues - Full result:', JSON.stringify(result, null, 2));
-        
-        let responseText = result.summary || `Component values retrieved`;
-        
-        // Add detailed property information if available
-        if (result.properties && Object.keys(result.properties).length > 0) {
-            console.log('[DEBUG] Properties found:', Object.keys(result.properties).length);
-            responseText += '\n\nProperties:';
-            for (const [key, value] of Object.entries(result.properties)) {
-                if (value && typeof value === 'object') {
-                    if (value.error) {
-                        responseText += `\n- ${key}: ERROR - ${value.error}`;
-                    } else {
-                        const valueStr = value.value ? JSON.stringify(value.value, null, 2) : 'null';
-                        const typeStr = value.type || 'unknown';
-                        responseText += `\n- ${key} (${typeStr}): ${valueStr}`;
-                        
-                        // Add range info if available
-                        if (value.range) {
-                            responseText += ` [range: ${value.range.min}-${value.range.max}]`;
-                        }
-                        
-                        // Add tooltip if available
-                        if (value.tooltip) {
-                            responseText += ` // ${value.tooltip}`;
-                        }
-                        
-                        // Add serialization info
-                        if (value.serialized) {
-                            responseText += ` (SerializeField)`;
-                        }
-                        if (value.hiddenInInspector) {
-                            responseText += ` (HideInInspector)`;
-                        }
-                    }
-                }
+    let responseText = result.summary || `Component values retrieved`;
+
+    // Add detailed property information if available
+    if (result.properties && Object.keys(result.properties).length > 0) {
+      console.log('[DEBUG] Properties found:', Object.keys(result.properties).length);
+      responseText += '\n\nProperties:';
+      for (const [key, value] of Object.entries(result.properties)) {
+        if (value && typeof value === 'object') {
+          if (value.error) {
+            responseText += `\n- ${key}: ERROR - ${value.error}`;
+          } else {
+            const valueStr = value.value ? JSON.stringify(value.value, null, 2) : 'null';
+            const typeStr = value.type || 'unknown';
+            responseText += `\n- ${key} (${typeStr}): ${valueStr}`;
+
+            // Add range info if available
+            if (value.range) {
+              responseText += ` [range: ${value.range.min}-${value.range.max}]`;
             }
-        } else {
-            console.log('[DEBUG] No properties found in result');
-            console.log('[DEBUG] Result keys:', Object.keys(result));
-        }
-        
-        // Add debug information if available
-        if (result.debug) {
-            responseText += '\n\nDebug Info:';
-            responseText += `\n- Properties type: ${result.debug.propertiesType}`;
-            responseText += `\n- Properties count: ${result.debug.propertiesCount}`;
-            if (result.debug.firstPropertyKey) {
-                responseText += `\n- First property key: ${result.debug.firstPropertyKey}`;
+
+            // Add tooltip if available
+            if (value.tooltip) {
+              responseText += ` // ${value.tooltip}`;
+            }
+
+            // Add serialization info
+            if (value.serialized) {
+              responseText += ` (SerializeField)`;
             }
+            if (value.hiddenInInspector) {
+              responseText += ` (HideInInspector)`;
+            }
+          }
         }
-        
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: responseText
-                }
-            ],
-            isError: false
-        };
-    } catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Failed to get component values: ${error.message}`
-                }
-            ],
-            isError: true
-        };
+      }
+    } else {
+      console.log('[DEBUG] No properties found in result');
+      console.log('[DEBUG] Result keys:', Object.keys(result));
+    }
+
+    // Add debug information if available
+    if (result.debug) {
+      responseText += '\n\nDebug Info:';
+      responseText += `\n- Properties type: ${result.debug.propertiesType}`;
+      responseText += `\n- Properties count: ${result.debug.propertiesCount}`;
+      if (result.debug.firstPropertyKey) {
+        responseText += `\n- First property key: ${result.debug.firstPropertyKey}`;
+      }
     }
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: responseText
+        }
+      ],
+      isError: false
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Failed to get component values: ${error.message}`
+        }
+      ],
+      isError: true
+    };
+  }
 }

package/src/tools/analysis/getGameObjectDetails.js

@@ -2,158 +2,158 @@
  * Tool definition for analysis_gameobject_details_get
  */
 export const getGameObjectDetailsToolDefinition = {
-    name: 'analysis_gameobject_details_get',
-    description: 'Get details for a GameObject by name or path (children/components/materials).',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            gameObjectName: {
-                type: 'string',
-                description: 'Name of the GameObject to inspect'
-            },
-            path: {
-                type: 'string',
-                description: 'Full hierarchy path to the GameObject (use either name or path)'
-            },
-            includeChildren: {
-                type: 'boolean',
-                description: 'Include full hierarchy details. Default: false'
-            },
-            includeComponents: {
-                type: 'boolean',
-                description: 'Include all component details. Default: true'
-            },
-            includeMaterials: {
-                type: 'boolean',
-                description: 'Include material information. Default: false'
-            },
-            maxDepth: {
-                type: 'number',
-                description: 'Maximum depth for child traversal. Default: 3, Range: 0-10'
-            }
-        },
-        required: ['gameObjectName']
-    }
+  name: 'analysis_gameobject_details_get',
+  description: 'Get details for a GameObject by name or path (children/components/materials).',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      gameObjectName: {
+        type: 'string',
+        description: 'Name of the GameObject to inspect'
+      },
+      path: {
+        type: 'string',
+        description: 'Full hierarchy path to the GameObject (use either name or path)'
+      },
+      includeChildren: {
+        type: 'boolean',
+        description: 'Include full hierarchy details. Default: false'
+      },
+      includeComponents: {
+        type: 'boolean',
+        description: 'Include all component details. Default: true'
+      },
+      includeMaterials: {
+        type: 'boolean',
+        description: 'Include material information. Default: false'
+      },
+      maxDepth: {
+        type: 'number',
+        description: 'Maximum depth for child traversal. Default: 3, Range: 0-10'
+      }
+    },
+    required: ['gameObjectName']
+  }
 };
 
 /**
  * Handler for get_gameobject_details tool
  */
 export async function getGameObjectDetailsHandler(unityConnection, args) {
-    try {
-        // Check connection
-        if (!unityConnection.isConnected()) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Failed to get GameObject details: Unity connection not available'
-                    }
-                ],
-                isError: true
-            };
-        }
+  try {
+    // Check connection
+    if (!unityConnection.isConnected()) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'Failed to get GameObject details: Unity connection not available'
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Validate that either gameObjectName or path is provided
-        if (!args.gameObjectName && !args.path) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Failed to get GameObject details: Either gameObjectName or path must be provided'
-                    }
-                ],
-                isError: true
-            };
-        }
+    // Validate that either gameObjectName or path is provided
+    if (!args.gameObjectName && !args.path) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'Failed to get GameObject details: Either gameObjectName or path must be provided'
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Validate that only one identifier is provided
-        if (args.gameObjectName && args.path) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Failed to get GameObject details: Provide either gameObjectName or path, not both'
-                    }
-                ],
-                isError: true
-            };
-        }
+    // Validate that only one identifier is provided
+    if (args.gameObjectName && args.path) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'Failed to get GameObject details: Provide either gameObjectName or path, not both'
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Validate maxDepth if provided
-        if (args.maxDepth !== undefined) {
-            if (args.maxDepth < 0 || args.maxDepth > 10) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: 'Failed to get GameObject details: maxDepth must be between 0 and 10'
-                        }
-                    ],
-                    isError: true
-                };
+    // Validate maxDepth if provided
+    if (args.maxDepth !== undefined) {
+      if (args.maxDepth < 0 || args.maxDepth > 10) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: 'Failed to get GameObject details: maxDepth must be between 0 and 10'
             }
-        }
+          ],
+          isError: true
+        };
+      }
+    }
 
-        // Build params only with provided values and defaults where needed
-        const params = {};
-        
-        if (args.gameObjectName) params.gameObjectName = args.gameObjectName;
-        if (args.path) params.path = args.path;
-        if (args.includeChildren !== undefined) params.includeChildren = args.includeChildren;
-        if (args.includeComponents !== undefined) params.includeComponents = args.includeComponents;
-        if (args.includeMaterials !== undefined) params.includeMaterials = args.includeMaterials;
-        if (args.maxDepth !== undefined) params.maxDepth = args.maxDepth;
+    // Build params only with provided values and defaults where needed
+    const params = {};
 
-        // Send command to Unity
-        const result = await unityConnection.sendCommand('analysis_gameobject_details_get', args);
+    if (args.gameObjectName) params.gameObjectName = args.gameObjectName;
+    if (args.path) params.path = args.path;
+    if (args.includeChildren !== undefined) params.includeChildren = args.includeChildren;
+    if (args.includeComponents !== undefined) params.includeComponents = args.includeComponents;
+    if (args.includeMaterials !== undefined) params.includeMaterials = args.includeMaterials;
+    if (args.maxDepth !== undefined) params.maxDepth = args.maxDepth;
 
-        // The unityConnection.sendCommand already extracts the result field
-        // from the response, so we access properties directly on result
-        if (!result || typeof result === 'string') {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Failed to get GameObject details: Invalid response format`
-                    }
-                ],
-                isError: true
-            };
-        }
+    // Send command to Unity
+    const result = await unityConnection.sendCommand('analysis_gameobject_details_get', args);
 
-        // Check if result has error property (error response from Unity)
-        if (result.error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Failed to get GameObject details: ${result.error}`
-                    }
-                ],
-                isError: true
-            };
-        }
+    // The unityConnection.sendCommand already extracts the result field
+    // from the response, so we access properties directly on result
+    if (!result || typeof result === 'string') {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Failed to get GameObject details: Invalid response format`
+          }
+        ],
+        isError: true
+      };
+    }
 
-        // Success response - result is already the unwrapped data
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: result.summary || `GameObject details retrieved`
-                }
-            ],
-            isError: false
-        };
-    } catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Failed to get GameObject details: ${error.message}`
-                }
-            ],
-            isError: true
-        };
+    // Check if result has error property (error response from Unity)
+    if (result.error) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Failed to get GameObject details: ${result.error}`
+          }
+        ],
+        isError: true
+      };
     }
+
+    // Success response - result is already the unwrapped data
+    return {
+      content: [
+        {
+          type: 'text',
+          text: result.summary || `GameObject details retrieved`
+        }
+      ],
+      isError: false
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Failed to get GameObject details: ${error.message}`
+        }
+      ],
+      isError: true
+    };
+  }
 }