Added new Add asset to scene tool

Added scroller on the help tab to allow user to visualize all the data

Author: CoderGamester

Editor/Resources/GetConsoleLogsResource.cs

@@ -28,7 +28,7 @@ public GetConsoleLogsResource()
         {
             Name = "get_console_logs";
             Description = "Retrieves all logs from the Unity console";
-            Uri = "logs://console";
+            Uri = "unity://logs";
 
             // Register for log messages
             Application.logMessageReceived += OnLogMessageReceived;

Editor/Tools/AddAssetToSceneTool.cs

@@ -0,0 +1,145 @@
+using System;
+using UnityEngine;
+using UnityEditor;
+using Newtonsoft.Json.Linq;
+using McpUnity.Unity;
+
+namespace McpUnity.Tools
+{
+    /// <summary>
+    /// Tool for adding assets from the AssetDatabase to the Unity scene
+    /// </summary>
+    public class AddAssetToSceneTool : McpToolBase
+    {
+        public AddAssetToSceneTool()
+        {
+            Name = "add_asset_to_scene";
+            Description = "Adds an asset from the AssetDatabase to the Unity scene";
+        }
+        
+        /// <summary>
+        /// Execute the AddAssetToScene tool with the provided parameters
+        /// </summary>
+        /// <param name="parameters">Tool parameters as a JObject</param>
+        public override JObject Execute(JObject parameters)
+        {
+            // Extract parameters
+            string assetPath = parameters["assetPath"]?.ToObject<string>();
+            string guid = parameters["guid"]?.ToObject<string>();
+            Vector3 position = parameters["position"]?.ToObject<JObject>() != null 
+                ? new Vector3(
+                    parameters["position"]["x"]?.ToObject<float>() ?? 0f,
+                    parameters["position"]["y"]?.ToObject<float>() ?? 0f,
+                    parameters["position"]["z"]?.ToObject<float>() ?? 0f
+                ) 
+                : Vector3.zero;
+            
+            // Optional parent game object
+            string parentPath = parameters["parentPath"]?.ToObject<string>();
+            int? parentId = parameters["parentId"]?.ToObject<int?>();
+            
+            // Validate parameters - require either assetPath or guid
+            if (string.IsNullOrEmpty(assetPath) && string.IsNullOrEmpty(guid))
+            {
+                return McpUnitySocketHandler.CreateErrorResponse(
+                    "Required parameter 'assetPath' or 'guid' not provided", 
+                    "validation_error"
+                );
+            }
+            
+            // If we have a GUID but no path, convert GUID to path
+            if (string.IsNullOrEmpty(assetPath) && !string.IsNullOrEmpty(guid))
+            {
+                assetPath = AssetDatabase.GUIDToAssetPath(guid);
+                if (string.IsNullOrEmpty(assetPath))
+                {
+                    return McpUnitySocketHandler.CreateErrorResponse(
+                        $"Asset with GUID '{guid}' not found", 
+                        "not_found_error"
+                    );
+                }
+            }
+            
+            // Load the asset
+            UnityEngine.Object asset = AssetDatabase.LoadAssetAtPath<UnityEngine.Object>(assetPath);
+            if (asset == null)
+            {
+                return McpUnitySocketHandler.CreateErrorResponse(
+                    $"Failed to load asset at path '{assetPath}'", 
+                    "not_found_error"
+                );
+            }
+            
+            // Check if the asset is a prefab or another type that can be instantiated
+            bool isPrefab = PrefabUtility.GetPrefabAssetType(asset) != PrefabAssetType.NotAPrefab;
+            bool canInstantiate = asset is GameObject || isPrefab;
+            
+            if (!canInstantiate)
+            {
+                return McpUnitySocketHandler.CreateErrorResponse(
+                    $"Asset of type '{asset.GetType().Name}' cannot be instantiated in the scene", 
+                    "invalid_asset_type"
+                );
+            }
+            
+            // Instantiate the asset
+            GameObject instance = null;
+            try
+            {
+                instance = (GameObject)PrefabUtility.InstantiatePrefab(asset);
+                
+                // Set position
+                instance.transform.position = position;
+                
+                // Set parent if specified
+                if (!string.IsNullOrEmpty(parentPath) || parentId.HasValue)
+                {
+                    GameObject parent = null;
+                    
+                    // Try to find parent by ID first
+                    if (parentId.HasValue)
+                    {
+                        parent = EditorUtility.InstanceIDToObject(parentId.Value) as GameObject;
+                    }
+                    // Otherwise try to find by path
+                    else if (!string.IsNullOrEmpty(parentPath))
+                    {
+                        parent = GameObject.Find(parentPath);
+                    }
+                    
+                    if (parent != null)
+                    {
+                        instance.transform.SetParent(parent.transform, false);
+                    }
+                    else
+                    {
+                        Debug.LogWarning($"[MCP Unity] Parent object not found, asset will be created at the root of the scene");
+                    }
+                }
+                
+                // Select the newly created object
+                Selection.activeGameObject = instance;
+                EditorGUIUtility.PingObject(instance);
+            }
+            catch (Exception ex)
+            {
+                return McpUnitySocketHandler.CreateErrorResponse(
+                    $"Error instantiating asset: {ex.Message}", 
+                    "instantiation_error"
+                );
+            }
+            
+            // Log the action
+            Debug.Log($"[MCP Unity] Added asset '{asset.name}' to scene from path '{assetPath}'");
+            
+            // Create the response
+            return new JObject
+            {
+                ["success"] = true,
+                ["type"] = "text",
+                ["message"] = $"Successfully added asset '{asset.name}' with instance ID {instance.GetInstanceID()} to the scene",
+                ["instanceId"] = instance.GetInstanceID()
+            };
+        }
+    }
+}

Editor/Tools/AddAssetToSceneTool.cs.meta

@@ -21,6 +21,7 @@ public class McpUnityEditorWindow : EditorWindow
         private bool _isInitialized = false;
         private string _mcpConfigJson = "";
         private bool _tabsIndentationJson = false;
+        private Vector2 _helpTabScrollPosition = Vector2.zero;
 
         [MenuItem("Tools/MCP Unity/Server Window", false, 1)]
         public static void ShowWindow()
@@ -201,9 +202,12 @@ private void DrawServerTab()
 
             EditorGUILayout.EndVertical();
         }
-
+        
         private void DrawHelpTab()
         {
+            // Begin scrollable area
+            _helpTabScrollPosition = EditorGUILayout.BeginScrollView(_helpTabScrollPosition);
+            
             WrappedLabel("About MCP Unity", _subHeaderStyle);
             EditorGUILayout.BeginVertical(_boxStyle);
             WrappedLabel("MCP Unity is a Unity Editor integration of the Model Context Protocol (MCP), which enables standardized communication between AI models and applications.");
@@ -299,6 +303,15 @@ private void DrawHelpTab()
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
             WrappedLabel("Send a notification to Unity that the task has been completed", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
             EditorGUILayout.EndVertical();
+            EditorGUILayout.Space();
+            
+            // add_asset_to_scene
+            WrappedLabel("add_asset_to_scene", EditorStyles.boldLabel);
+            WrappedLabel("Adds an asset from the AssetDatabase to the Unity scene");
+            EditorGUILayout.BeginVertical(EditorStyles.helpBox);
+            EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
+            WrappedLabel("Add the Player prefab from my project to the current scene", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
+            EditorGUILayout.EndVertical();
 
             EditorGUILayout.EndVertical();
 
@@ -308,62 +321,62 @@ private void DrawHelpTab()
 
             EditorGUILayout.BeginVertical(_boxStyle);
 
-            // get_menu_items
-            WrappedLabel("get_menu_items", EditorStyles.boldLabel);
+            // unity://menu-items
+            WrappedLabel("unity://menu-items", EditorStyles.boldLabel);
             WrappedLabel("Retrieves a list of all available menu items in the Unity Editor");
             EditorGUILayout.BeginVertical(EditorStyles.helpBox);
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
             WrappedLabel("Show me all available menu items related to GameObject creation", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
             EditorGUILayout.EndVertical();
             EditorGUILayout.Space();
 
-            // get_hierarchy
-            WrappedLabel("get_hierarchy", EditorStyles.boldLabel);
+            // unity://hierarchy
+            WrappedLabel("unity://hierarchy", EditorStyles.boldLabel);
             WrappedLabel("Retrieves a list of all game objects in the Unity hierarchy");
             EditorGUILayout.BeginVertical(EditorStyles.helpBox);
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
             WrappedLabel("Show me the current scene hierarchy structure", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
             EditorGUILayout.EndVertical();
             EditorGUILayout.Space();
 
-            // get_gameobject
-            WrappedLabel("get_gameobject", EditorStyles.boldLabel);
+            // unity://gameobject/{id}
+            WrappedLabel("unity://gameobject/{id}", EditorStyles.boldLabel);
             WrappedLabel("Retrieves detailed information about a specific GameObject, including all components with serialized properties and fields");
             EditorGUILayout.BeginVertical(EditorStyles.helpBox);
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
             WrappedLabel("Get me detailed information about the Player GameObject", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
             EditorGUILayout.EndVertical();
             EditorGUILayout.Space();
 
-            // get_console_logs
-            WrappedLabel("get_console_logs", EditorStyles.boldLabel);
+            // unity://logs
+            WrappedLabel("unity://logs", EditorStyles.boldLabel);
             WrappedLabel("Retrieves a list of all logs from the Unity console");
             EditorGUILayout.BeginVertical(EditorStyles.helpBox);
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
             WrappedLabel("Show me the recent error messages from the Unity console", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
             EditorGUILayout.EndVertical();
             EditorGUILayout.Space();
 
-            // get_packages
-            WrappedLabel("get_packages", EditorStyles.boldLabel);
+            // unity://packages
+            WrappedLabel("unity://packages", EditorStyles.boldLabel);
             WrappedLabel("Retrieves information about installed and available packages from the Unity Package Manager");
             EditorGUILayout.BeginVertical(EditorStyles.helpBox);
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
             WrappedLabel("List all the packages currently installed in my Unity project", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
             EditorGUILayout.EndVertical();
             EditorGUILayout.Space();
 
-            // get_assets
-            WrappedLabel("get_assets", EditorStyles.boldLabel);
+            // unity://assets
+            WrappedLabel("unity://assets", EditorStyles.boldLabel);
             WrappedLabel("Retrieves information about assets in the Unity Asset Database");
             EditorGUILayout.BeginVertical(EditorStyles.helpBox);
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
             WrappedLabel("Find all texture assets in my project", new GUIStyle(EditorStyles.miniLabel) { fontStyle = FontStyle.Italic });
             EditorGUILayout.EndVertical();
             EditorGUILayout.Space();
 
-            // get_tests
-            WrappedLabel("get_tests", EditorStyles.boldLabel);
+            // unity://tests/{testMode}
+            WrappedLabel("unity://tests/{testMode}", EditorStyles.boldLabel);
             WrappedLabel("Retrieves information about tests in the Unity Test Runner");
             EditorGUILayout.BeginVertical(EditorStyles.helpBox);
             EditorGUILayout.LabelField("Example prompt:", EditorStyles.miniLabel);
@@ -400,6 +413,9 @@ private void DrawHelpTab()
             EditorGUILayout.EndHorizontal();
 
             EditorGUILayout.EndVertical();
+            
+            // End scrollable area
+            EditorGUILayout.EndScrollView();
         }
 
         #endregion

Editor/UnityBridge/McpUnityEditorWindow.cs

@@ -168,6 +168,10 @@ private void RegisterTools()
             // Register UpdateComponentTool
             UpdateComponentTool updateComponentTool = new UpdateComponentTool();
             _tools.Add(updateComponentTool.Name, updateComponentTool);
+            
+            // Register AddAssetToSceneTool
+            AddAssetToSceneTool addAssetToSceneTool = new AddAssetToSceneTool();
+            _tools.Add(addAssetToSceneTool.Name, addAssetToSceneTool);
         }
 
         /// <summary>

Editor/UnityBridge/McpUnityServer.cs

@@ -45,6 +45,10 @@ MCP Unity is an implementation of the Model Context Protocol for Unity Editor, a
 
 ## Features
 
+<a href="https://glama.ai/mcp/servers/@CoderGamester/mcp-unity">
+  <img width="400" height="200" src="https://glama.ai/mcp/servers/@CoderGamester/mcp-unity/badge" alt="Unity MCP server" />
+</a>
+
 ### IDE Integration - Package Cache Access
 
 MCP Unity provides automatic integration with VSCode-like IDEs (Visual Studio Code, Cursor, Windsurf) by adding the Unity `Library/PackedCache` folder to your workspace. This feature:
@@ -55,53 +59,50 @@ MCP Unity provides automatic integration with VSCode-like IDEs (Visual Studio Co
 
 ### MCP Server Tools
 
-This MCP currently provides the following <ins>tools</ins>:
-
-- <ins>**execute_menu_item**</ins>: Executes Unity menu items (functions tagged with the MenuItem attribute)
+- `execute_menu_item`: Executes Unity menu items (functions tagged with the MenuItem attribute)
   > **Example prompt:** "Execute the menu item 'GameObject/Create Empty' to create a new empty GameObject"
 
-- <ins>**select_gameobject**</ins>: Selects game objects in the Unity hierarchy by path or instance ID
+- `select_gameobject`: Selects game objects in the Unity hierarchy by path or instance ID
   > **Example prompt:** "Select the Main Camera object in my scene"
 
-- <ins>**update_component**</ins>: Updates component fields on a GameObject or adds it to the GameObject if it does not contain the component
+- `update_component`: Updates component fields on a GameObject or adds it to the GameObject if it does not contain the component
   > **Example prompt:** "Add a Rigidbody component to the Player object and set its mass to 5"
 
-- <ins>**add_package**</ins>: Installs new packages in the Unity Package Manager
+- `add_package`: Installs new packages in the Unity Package Manager
   > **Example prompt:** "Add the TextMeshPro package to my project"
 
-- <ins>**run_tests**</ins>: Runs tests using the Unity Test Runner
+- `run_tests`: Runs tests using the Unity Test Runner
   > **Example prompt:** "Run all the EditMode tests in my project"
 
-- <ins>**notify_message**</ins>: Displays messages in the Unity Editor
+- `notify_message`: Displays messages in the Unity Editor
   > **Example prompt:** "Send a notification to Unity that the task has been completed"
 
+- `add_asset_to_scene`: Adds an asset from the AssetDatabase to the Unity scene
+  > **Example prompt:** "Add the Player prefab from my project to the current scene"
+
 ### MCP Server Resources
 
-- <ins>**get_menu_items**</ins>: Retrieves a list of all available menu items in the Unity Editor to facilitate <ins>**execute_menu_item**</ins> tool
+- `unity://menu-items`: Retrieves a list of all available menu items in the Unity Editor to facilitate `execute_menu_item` tool
   > **Example prompt:** "Show me all available menu items related to GameObject creation"
 
-- <ins>**get_hierarchy**</ins>: Retrieves a list of all game objects in the Unity hierarchy
+- `unity://hierarchy`: Retrieves a list of all game objects in the Unity hierarchy
   > **Example prompt:** "Show me the current scene hierarchy structure"
 
-- <ins>**get_gameobject**</ins>: Retrieves detailed information about a specific GameObject by instance ID, including all GameObject components with it's serialized properties and fields
+- `unity://gameobject/{id}`: Retrieves detailed information about a specific GameObject by instance ID or object path in the scene hierarchy, including all GameObject components with it's serialized properties and fields
   > **Example prompt:** "Get me detailed information about the Player GameObject"
 
-- <ins>**get_console_logs**</ins>: Retrieves a list of all logs from the Unity console
+- `unity://logs`: Retrieves a list of all logs from the Unity console
   > **Example prompt:** "Show me the recent error messages from the Unity console"
 
-- <ins>**get_packages**</ins>: Retrieves information about installed and available packages from the Unity Package Manager
+- `unity://packages`: Retrieves information about installed and available packages from the Unity Package Manager
   > **Example prompt:** "List all the packages currently installed in my Unity project"
 
-- <ins>**get_assets**</ins>: Retrieves information about assets in the Unity Asset Database
+- `unity://assets`: Retrieves information about assets in the Unity Asset Database
   > **Example prompt:** "Find all texture assets in my project"
 
-- <ins>**get_tests**</ins>: Retrieves information about tests in the Unity Test Runner
+- `unity://tests/{testMode}`: Retrieves information about tests in the Unity Test Runner
   > **Example prompt:** "List all available tests in my Unity project"
 
-<a href="https://glama.ai/mcp/servers/@CoderGamester/mcp-unity">
-  <img width="400" height="200" src="https://glama.ai/mcp/servers/@CoderGamester/mcp-unity/badge" alt="Unity MCP server" />
-</a>
-
 ## Requirements
 - Unity 2022.3 or later - to [install the server](#install-server)
 - Node.js 18 or later - to [start the server](#start-server)
@@ -342,8 +343,9 @@ Don't forget to shutdown the server with `Ctrl + C` before closing the terminal
 If you have any questions or need support, please open an [issue](https://github.com/CoderGamester/mcp-unity/issues) on this repository.
 
 Alternative you can reach out on:
-- [![](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white 'LinkedIn')](https://www.linkedin.com/in/miguel-tomas/)
+- Linkedin: [![](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white 'LinkedIn')](https://www.linkedin.com/in/miguel-tomas/)
 - Discord: gamester7178
+- Email: game.gamester@gmail.com
 
 ## Contributing