Scene Traversal 최적화:

Dictionary<string, object> 대신 경량 DTO HierarchyNode를 사용하여 가비지 컬렉션(GC) 부하를 줄였습니다.
maxDepth 파라미터를 추가하여(기본값 20), 무한히 깊은 계층 구조로 인한 프리징을 방지했습니다.
Asset Search 최적화:
Lazy Loading: 메타데이터만 필요한 경우, 무거운 에셋 객체(UnityEngine.Object)를 로드하지 않도록 개선하여 메모리 사용량을 대폭 절감했습니다.
Early Filtering: 검색 결과 전체를 로드하고 필터링하던 방식에서, 경로만 먼저 필터링하고 페이지네이션에 해당하는 항목만 로드하도록 변경했습니다. (수천 개 에셋 검색 시 속도 향상)
Reflection Caching:
AssetService에 PropertyInfo/FieldInfo 캐시를 도입하여, 반복적인 리플렉션 탐색 비용을 제거했습니다.

Author: choej2303

MCPForUnity/Editor/Services/AssetService.cs

@@ -458,26 +458,36 @@ public static object SearchAssets(JObject @params)
             try
             {
                 string[] guids = AssetDatabase.FindAssets(string.Join(" ", searchFilters), folderScope);
-                List<object> results = new List<object>();
+                
+                // Optimization: Filter paths first without creating full data objects
+                List<string> matchedPaths = new List<string>();
                 int totalFound = 0;
 
                 foreach (string guid in guids)
                 {
                     string assetPath = AssetDatabase.GUIDToAssetPath(guid);
                     if (string.IsNullOrEmpty(assetPath)) continue;
 
+                    // I/O Check only if filter is active
                     if (filterDateAfter.HasValue)
                     {
                         DateTime lastWriteTime = File.GetLastWriteTimeUtc(Path.Combine(Directory.GetCurrentDirectory(), assetPath));
                         if (lastWriteTime <= filterDateAfter.Value) continue;
                     }
 
+                    matchedPaths.Add(assetPath);
                     totalFound++;
-                    results.Add(GetAssetData(assetPath, generatePreview));
                 }
 
+                // Optimization: Page BEFORE fetching heavy data
                 int startIndex = (pageNumber - 1) * pageSize;
-                var pagedResults = results.Skip(startIndex).Take(pageSize).ToList();
+                var pagedPaths = matchedPaths.Skip(startIndex).Take(pageSize);
+                
+                List<object> pagedResults = new List<object>();
+                foreach (var path in pagedPaths)
+                {
+                   pagedResults.Add(GetAssetData(path, generatePreview));
+                }
 
                 return new SuccessResponse(
                     $"Found {totalFound} asset(s). Returning page {pageNumber} ({pagedResults.Count} assets).",
@@ -606,27 +616,45 @@ private static bool ApplyObjectProperties(UnityEngine.Object target, JObject pro
             return modified;
         }
 
+        // --- Reflection Cache ---
+        private static readonly Dictionary<(Type, string), System.Reflection.PropertyInfo> _propertyCache = new Dictionary<(Type, string), System.Reflection.PropertyInfo>();
+        private static readonly Dictionary<(Type, string), System.Reflection.FieldInfo> _fieldCache = new Dictionary<(Type, string), System.Reflection.FieldInfo>();
+
         private static bool SetPropertyOrField(object target, string memberName, JToken value, Type type)
         {
             type = type ?? target.GetType();
-            System.Reflection.BindingFlags flags = System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.IgnoreCase;
-
+            // System.Reflection.BindingFlags flags = System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.IgnoreCase;
+            // Note: Caching logic assumes flags don't change.
+            
             try {
-                System.Reflection.PropertyInfo propInfo = type.GetProperty(memberName, flags);
+                // Try Property Cache
+                if (!_propertyCache.TryGetValue((type, memberName), out var propInfo))
+                {
+                    propInfo = type.GetProperty(memberName, System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.IgnoreCase);
+                    if (propInfo != null) _propertyCache[(type, memberName)] = propInfo;
+                }
+
                 if (propInfo != null && propInfo.CanWrite) {
                     object val = ConvertJTokenToType(value, propInfo.PropertyType);
                     if (val != null && !object.Equals(propInfo.GetValue(target), val)) {
                         propInfo.SetValue(target, val);
                         return true;
                     }
-                } else {
-                    System.Reflection.FieldInfo fieldInfo = type.GetField(memberName, flags);
-                    if (fieldInfo != null) {
-                        object val = ConvertJTokenToType(value, fieldInfo.FieldType);
-                        if (val != null && !object.Equals(fieldInfo.GetValue(target), val)) {
-                            fieldInfo.SetValue(target, val);
-                            return true;
-                        }
+                    return false; // Found but didn't change or couldn't convert
+                }
+
+                // Try Field Cache
+                 if (!_fieldCache.TryGetValue((type, memberName), out var fieldInfo))
+                {
+                    fieldInfo = type.GetField(memberName, System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.IgnoreCase);
+                    if (fieldInfo != null) _fieldCache[(type, memberName)] = fieldInfo;
+                }
+
+                if (fieldInfo != null) {
+                    object val = ConvertJTokenToType(value, fieldInfo.FieldType);
+                    if (val != null && !object.Equals(fieldInfo.GetValue(target), val)) {
+                        fieldInfo.SetValue(target, val);
+                        return true;
                     }
                 }
             } catch (Exception ex) {
@@ -680,35 +708,42 @@ private static object GetAssetData(string path, bool generatePreview = false)
 
             string guid = AssetDatabase.AssetPathToGUID(path);
             Type assetType = AssetDatabase.GetMainAssetTypeAtPath(path);
-            UnityEngine.Object asset = AssetDatabase.LoadAssetAtPath<UnityEngine.Object>(path);
+            
+            // Lazy Load: Only load object if preview is requested
+            UnityEngine.Object asset = null;
             string previewBase64 = null;
             int previewWidth = 0;
             int previewHeight = 0;
+            int instanceID = 0;
 
-            if (generatePreview && asset != null)
+            if (generatePreview)
             {
-                Texture2D preview = AssetPreview.GetAssetPreview(asset);
-                if (preview != null) {
-                    try {
-                        // (Preview generation logic omitted for brevity in summary, assume same logic)
-                         RenderTexture rt = RenderTexture.GetTemporary(preview.width, preview.height);
-                         Graphics.Blit(preview, rt);
-                         RenderTexture previous = RenderTexture.active;
-                         RenderTexture.active = rt;
-                         Texture2D readablePreview = new Texture2D(preview.width, preview.height, TextureFormat.RGB24, false);
-                         readablePreview.ReadPixels(new Rect(0, 0, rt.width, rt.height), 0, 0);
-                         readablePreview.Apply();
-                         RenderTexture.active = previous;
-                         RenderTexture.ReleaseTemporary(rt);
-                         
-                         byte[] pngData = readablePreview.EncodeToPNG();
-                         if (pngData != null) {
-                             previewBase64 = Convert.ToBase64String(pngData);
-                             previewWidth = readablePreview.width;
-                             previewHeight = readablePreview.height;
-                         }
-                         UnityEngine.Object.DestroyImmediate(readablePreview);
-                    } catch {}
+                asset = AssetDatabase.LoadAssetAtPath<UnityEngine.Object>(path);
+                if (asset != null)
+                {
+                    instanceID = asset.GetInstanceID();
+                    Texture2D preview = AssetPreview.GetAssetPreview(asset);
+                    if (preview != null) {
+                        try {
+                             RenderTexture rt = RenderTexture.GetTemporary(preview.width, preview.height);
+                             Graphics.Blit(preview, rt);
+                             RenderTexture previous = RenderTexture.active;
+                             RenderTexture.active = rt;
+                             Texture2D readablePreview = new Texture2D(preview.width, preview.height, TextureFormat.RGB24, false);
+                             readablePreview.ReadPixels(new Rect(0, 0, rt.width, rt.height), 0, 0);
+                             readablePreview.Apply();
+                             RenderTexture.active = previous;
+                             RenderTexture.ReleaseTemporary(rt);
+                             
+                             byte[] pngData = readablePreview.EncodeToPNG();
+                             if (pngData != null) {
+                                 previewBase64 = Convert.ToBase64String(pngData);
+                                 previewWidth = readablePreview.width;
+                                 previewHeight = readablePreview.height;
+                             }
+                             UnityEngine.Object.DestroyImmediate(readablePreview);
+                        } catch {}
+                    }
                 }
             }
 
@@ -720,7 +755,7 @@ private static object GetAssetData(string path, bool generatePreview = false)
                 name = Path.GetFileNameWithoutExtension(path),
                 fileName = Path.GetFileName(path),
                 isFolder = AssetDatabase.IsValidFolder(path),
-                instanceID = asset?.GetInstanceID() ?? 0,
+                instanceID = instanceID, // 0 if not loaded
                 lastWriteTimeUtc = File.GetLastWriteTimeUtc(Path.Combine(Directory.GetCurrentDirectory(), path)).ToString("o"),
                 previewBase64 = previewBase64,
                 previewWidth = previewWidth,

MCPForUnity/Editor/Services/SceneTraversalService.cs

@@ -10,68 +10,88 @@ namespace MCPForUnity.Editor.Services
     /// </summary>
     public static class SceneTraversalService
     {
-        public static List<object> GetSceneHierarchyData(Scene scene)
+        [System.Serializable]
+        public class HierarchyNode
+        {
+            public string name;
+            public bool activeSelf;
+            public bool activeInHierarchy;
+            public string tag;
+            public int layer;
+            public bool isStatic;
+            public int instanceID;
+            public TransformData transform;
+            public List<HierarchyNode> children;
+        }
+
+        [System.Serializable]
+        public class TransformData
+        {
+            public Vector3Data position;
+            public Vector3Data rotation;
+            public Vector3Data scale;
+        }
+
+        [System.Serializable]
+        public struct Vector3Data
+        {
+            public float x, y, z;
+            public Vector3Data(Vector3 v) { x = v.x; y = v.y; z = v.z; }
+        }
+
+        public static List<HierarchyNode> GetSceneHierarchyData(Scene scene, int maxDepth = 20)
         {
             if (!scene.IsValid() || !scene.isLoaded)
             {
-                return new List<object>();
+                return new List<HierarchyNode>();
             }
 
             GameObject[] rootObjects = scene.GetRootGameObjects();
-            return rootObjects.Select(go => GetGameObjectDataRecursive(go)).ToList();
+            // Use initial capacity to avoid resizing
+            var result = new List<HierarchyNode>(rootObjects.Length);
+            
+            foreach (var go in rootObjects)
+            {
+                result.Add(GetGameObjectDataRecursive(go, 0, maxDepth));
+            }
+            return result;
         }
 
         /// <summary>
         /// Recursively builds a data representation of a GameObject and its children.
+        /// Uses DTOs to minimize GC overhead.
         /// </summary>
-        public static object GetGameObjectDataRecursive(GameObject go)
+        public static HierarchyNode GetGameObjectDataRecursive(GameObject go, int currentDepth, int maxDepth)
         {
-            if (go == null)
-                return null;
-
-            var childrenData = new List<object>();
-            foreach (Transform child in go.transform)
-            {
-                childrenData.Add(GetGameObjectDataRecursive(child.gameObject));
-            }
+            if (go == null) return null;
 
-            var gameObjectData = new Dictionary<string, object>
+            var node = new HierarchyNode
             {
-                { "name", go.name },
-                { "activeSelf", go.activeSelf },
-                { "activeInHierarchy", go.activeInHierarchy },
-                { "tag", go.tag },
-                { "layer", go.layer },
-                { "isStatic", go.isStatic },
-                { "instanceID", go.GetInstanceID() },
+                name = go.name,
+                activeSelf = go.activeSelf,
+                activeInHierarchy = go.activeInHierarchy,
+                tag = go.tag,
+                layer = go.layer,
+                isStatic = go.isStatic,
+                instanceID = go.GetInstanceID(),
+                transform = new TransformData
                 {
-                    "transform",
-                    new
-                    {
-                        position = new
-                        {
-                            x = go.transform.localPosition.x,
-                            y = go.transform.localPosition.y,
-                            z = go.transform.localPosition.z,
-                        },
-                        rotation = new
-                        {
-                            x = go.transform.localRotation.eulerAngles.x,
-                            y = go.transform.localRotation.eulerAngles.y,
-                            z = go.transform.localRotation.eulerAngles.z,
-                        },
-                        scale = new
-                        {
-                            x = go.transform.localScale.x,
-                            y = go.transform.localScale.y,
-                            z = go.transform.localScale.z,
-                        },
-                    }
-                },
-                { "children", childrenData },
+                    position = new Vector3Data(go.transform.localPosition),
+                    rotation = new Vector3Data(go.transform.localRotation.eulerAngles),
+                    scale = new Vector3Data(go.transform.localScale)
+                }
             };
 
-            return gameObjectData;
+            if (currentDepth < maxDepth && go.transform.childCount > 0)
+            {
+                node.children = new List<HierarchyNode>(go.transform.childCount);
+                foreach (Transform child in go.transform)
+                {
+                    node.children.Add(GetGameObjectDataRecursive(child.gameObject, currentDepth + 1, maxDepth));
+                }
+            }
+            
+            return node;
         }
     }
 }

MCPForUnity/Editor/Tools/ManageScene.cs

@@ -27,6 +27,7 @@ private sealed class SceneCommand
             public int? buildIndex { get; set; }
             public string fileName { get; set; } = string.Empty;
             public int? superSize { get; set; }
+            public int? maxDepth { get; set; }
         }
 
         private static SceneCommand ToSceneCommand(JObject p)
@@ -48,7 +49,8 @@ private static SceneCommand ToSceneCommand(JObject p)
                 path = p["path"]?.ToString() ?? string.Empty,
                 buildIndex = BI(p["buildIndex"] ?? p["build_index"]),
                 fileName = (p["fileName"] ?? p["filename"])?.ToString() ?? string.Empty,
-                superSize = BI(p["superSize"] ?? p["super_size"] ?? p["supersize"])
+                superSize = BI(p["superSize"] ?? p["super_size"] ?? p["supersize"]),
+                maxDepth = BI(p["maxDepth"] ?? p["max_depth"])
             };
         }
 
@@ -138,7 +140,7 @@ public static object HandleCommand(JObject @params)
                     return SaveScene(fullPath, relativePath);
                 case "get_hierarchy":
                     try { McpLog.Info("[ManageScene] get_hierarchy: entering", always: false); } catch { }
-                    var gh = GetSceneHierarchy();
+                    var gh = GetSceneHierarchy(cmd.maxDepth);
                     try { McpLog.Info("[ManageScene] get_hierarchy: exiting", always: false); } catch { }
                     return gh;
                 case "get_active":
@@ -453,7 +455,7 @@ private static object GetBuildSettingsScenes()
             }
         }
 
-        private static object GetSceneHierarchy()
+        private static object GetSceneHierarchy(int? maxDepth)
         {
             try
             {
@@ -468,7 +470,7 @@ private static object GetSceneHierarchy()
                 }
 
                 try { McpLog.Info("[ManageScene] get_hierarchy: fetching hierarchy data", always: false); } catch { }
-                var hierarchy = SceneTraversalService.GetSceneHierarchyData(activeScene);
+                var hierarchy = SceneTraversalService.GetSceneHierarchyData(activeScene, maxDepth ?? 20);
 
                 var resp = new SuccessResponse(
                     $"Retrieved hierarchy for scene '{activeScene.name}'.",