feat: restructure server instructions into workflow-focused format

- Reorganized instructions from flat bullet list into categorized workflow sections
- Emphasized critical script management workflow with numbered steps
- Improved readability and scannability for AI agents using the MCP server

It doesn't make sense to repeat the fucnction tools, they're already parsed

Author: msanatan

MCPForUnity/UnityMcpServer~/src/server.py

@@ -159,25 +159,32 @@ def _emit_startup():
     name="mcp-for-unity-server",
     lifespan=server_lifespan,
     instructions="""
-This server provides tools to interact with the Unity Game Engine Editor.\n\n
-Available tools:\n
-- `manage_editor`: Controls editor state and queries info.\n
-- `execute_menu_item`: Executes, lists and checks for the existence of Unity Editor menu items.\n
-- `read_console`: Reads or clears Unity console messages, with filtering options.\n
-- `manage_scene`: Manages scenes.\n
-- `manage_gameobject`: Manages GameObjects in the scene.\n
-- `manage_script`: Manages C# script files.\n
-- `manage_asset`: Manages prefabs and assets.\n
-- `manage_shader`: Manages shaders.\n
-- `reload_domain`: Triggers Unity domain reload to recompile scripts and refresh assemblies.\n\n
-Tips:\n
-- Always reload the domain after creating or modifying scripts before attempting to use them. Use `reload_domain` immediately after script changes, then check `read_console` for compile errors.\n
-- Create prefabs for reusable GameObjects.\n
-- Always include a camera and main light in your scenes.\n
-- Unless specified otherwise, paths are relative to the project's `Assets/` folder.\n
-- After creating or modifying scripts with `manage_script`, allow Unity to recompile; use `read_console` to check for compile errors.\n
-- Use `execute_menu_item` for interacting with Unity systems and third party tools like a user would.\n
+This server provides tools to interact with the Unity Game Engine Editor.
 
+Important Workflows:
+
+Script Management:
+1. After creating or modifying scripts with `manage_script`, ALWAYS call `reload_domain` immediately
+2. Wait for Unity to recompile (domain reload is asynchronous)
+3. Use `read_console` to check for compilation errors before proceeding
+4. Only after successful compilation can new components/types be used
+
+Scene Setup:
+- Always include a Camera and main Light (Directional Light) in new scenes
+- Create prefabs with `manage_asset` for reusable GameObjects
+- Use `manage_scene` to load, save, and query scene information
+
+Path Conventions:
+- Unless specified otherwise, all paths are relative to the project's `Assets/` folder
+- Use forward slashes (/) in paths for cross-platform compatibility
+
+Console Monitoring:
+- Check `read_console` regularly to catch errors, warnings, and compilation status
+- Filter by log type (Error, Warning, Log) to focus on specific issues
+
+Menu Items:
+- Use `execute_menu_item` when you have read the menu items resource
+- This let's you interact with Unity's menu system and third-party tools
 """
 )
 

Server/server.py

@@ -159,25 +159,32 @@ def _emit_startup():
     name="mcp-for-unity-server",
     lifespan=server_lifespan,
     instructions="""
-This server provides tools to interact with the Unity Game Engine Editor.\n\n
-Available tools:\n
-- `manage_editor`: Controls editor state and queries info.\n
-- `execute_menu_item`: Executes, lists and checks for the existence of Unity Editor menu items.\n
-- `read_console`: Reads or clears Unity console messages, with filtering options.\n
-- `manage_scene`: Manages scenes.\n
-- `manage_gameobject`: Manages GameObjects in the scene.\n
-- `manage_script`: Manages C# script files.\n
-- `manage_asset`: Manages prefabs and assets.\n
-- `manage_shader`: Manages shaders.\n
-- `reload_domain`: Triggers Unity domain reload to recompile scripts and refresh assemblies.\n\n
-Tips:\n
-- Always reload the domain after creating or modifying scripts before attempting to use them. Use `reload_domain` immediately after script changes, then check `read_console` for compile errors.\n
-- Create prefabs for reusable GameObjects.\n
-- Always include a camera and main light in your scenes.\n
-- Unless specified otherwise, paths are relative to the project's `Assets/` folder.\n
-- After creating or modifying scripts with `manage_script`, allow Unity to recompile; use `read_console` to check for compile errors.\n
-- Use `execute_menu_item` for interacting with Unity systems and third party tools like a user would.\n
+This server provides tools to interact with the Unity Game Engine Editor.
 
+Important Workflows:
+
+Script Management:
+1. After creating or modifying scripts with `manage_script`, ALWAYS call `reload_domain` immediately
+2. Wait for Unity to recompile (domain reload is asynchronous)
+3. Use `read_console` to check for compilation errors before proceeding
+4. Only after successful compilation can new components/types be used
+
+Scene Setup:
+- Always include a Camera and main Light (Directional Light) in new scenes
+- Create prefabs with `manage_asset` for reusable GameObjects
+- Use `manage_scene` to load, save, and query scene information
+
+Path Conventions:
+- Unless specified otherwise, all paths are relative to the project's `Assets/` folder
+- Use forward slashes (/) in paths for cross-platform compatibility
+
+Console Monitoring:
+- Check `read_console` regularly to catch errors, warnings, and compilation status
+- Filter by log type (Error, Warning, Log) to focus on specific issues
+
+Menu Items:
+- Use `execute_menu_item` when you have read the menu items resource
+- This let's you interact with Unity's menu system and third-party tools
 """
 )