New commands: get_scene_insights, get_node_insights

CONTRIBUTING.md

@@ -104,6 +104,17 @@ The following tools have been recently added:
   - Saves the screenshot to the specified path
   - Useful for visual debugging and feedback
 
+- **get_scene_insights**: Read scene files and identify nodes, scripts, signals, and how they interact
+  - Hierarchical node structure with attached script analysis (get_node_insights)
+  - Detects behavioral patterns: physics interactions, input handling, animation control
+  - Tracks signal connections and emissions across scene hierarchy
+
+- **get_node_insights**: Read GDScript files and identify classes, methods, signals, and dependencies
+  - Class structure including exports, signals, methods, and variables
+  - Dependency extraction from type hints, preloads, and resource paths
+  - Detects behavioral patterns: node queries, scene loading, tree manipulation
+  - Local variable type inference and method call analysis with context
+
 Example:
 
 ```typescript

README.md

@@ -76,6 +76,8 @@ This direct feedback loop helps AI assistants like Claude understand what works
   - Load sprites and textures into Sprite2D nodes
   - Export 3D scenes as MeshLibrary resources for GridMap
   - Save scenes with options for creating variants
+  - Get insights into scene structure, node hierarchy, signal connections, and behavioral patterns
+  - Get detailed script structure including classes, methods, signals, dependencies, and usage patterns
 - **UID Management** (for Godot 4.4+):
   - Get UID for specific files
   - Update UID references by resaving resources
@@ -129,7 +131,9 @@ Add to your Cline MCP settings file (`~/Library/Application Support/Code/User/gl
         "export_mesh_library",
         "save_scene",
         "get_uid",
-        "update_project_uids"
+        "update_project_uids",
+        "get_scene_insights",
+        "get_node_insights"
       ]
     }
   }
@@ -202,6 +206,8 @@ Once configured, your AI assistant will automatically run the MCP server when ne
 "Get the UID for a specific script file in my Godot 4.4 project"
 
 "Update UID references in my Godot project after upgrading to 4.4"
+
+"Review the scene structure of Main.tscn and trace why the player's health_changed signal isn't reaching the HealthBar UI element"
 ```
 
 ## Implementation Details

scripts/build.js

@@ -20,7 +20,13 @@ try {
     path.join(__dirname, '..', 'build', 'scripts', 'godot_operations.gd')
   );
 
-  console.log('Successfully copied godot_operations.gd to build/scripts');
+  // Copy the godot_insights.gd file
+  fs.copyFileSync(
+    path.join(__dirname, '..', 'src', 'scripts', 'godot_insights.gd'),
+    path.join(__dirname, '..', 'build', 'scripts', 'godot_insights.gd')
+  );
+
+  console.log('Successfully copied godot_operations.gd and godot_insights.gd to build/scripts');
 } catch (error) {
   console.error('Error copying scripts:', error);
   process.exit(1);