Release 1.1.0

What's Changed

New

• feat(prompt): implement robust GameObject handling workflow prompt for LLMs
• feat(unity-mcp): add update_gameobject tool and improve GameObject handling prompt
• feat(server): add get_console_logs tool to MCP Server Tools
• feat: Unity now installs the Node.js server and it's dependencies. Automatically runs on Unity starts with a new “Force Install Server” button for manual invoke in the Tools > MCP Unity > Server Window
• docs: add new FAQ section

Changed

• refactor(server): remove Server meta files by renaming Server to Server~ as Unity will ignore folders with ~ suffix
• refactor(server): rename all tool/resource registration functions to 'register' prefix and add prompt support
• refactor: update console logging and resource handling for more accurate output
• refactor(server): rename getConsoleLogResource to getConsoleLogsResource for consistency
• refactor: rename hierarchy resource and update documentation, updating resource URI from unity://hierarchy to unity://scenes-hierarchy
• refactor(utils): rename McpConfigUtils → McpUtils
• chore(node.js): remove build/ and node_modules/ folders as now they are built by Unity on start
• chore: remove the update pop up when changing the MCP port
• docs: remove duplicate MCP resource entries from README files

Fixed

• fix(server): update Zod imports and upgrade package to resolve schema errors;
• fix: ensure McpUnitySettings handles environment variables cross-platform
• fix: update mcp_config.json path for mcp-unity server to work on all platforms
• fix: now the windsurf config is properly setup
• fix: now all server and Unity environment variables are saved and obtained by the JSON settings file located in '../ProjectSettings/McpUnitySettings.json'.

New Contributors

• @twilight07 made their first contribution in #33
• @CoderGamester made their first contribution in #35

Full Changelog: 1.0.2...1.1.0

Release 1.0.2

What's Changed

New

• Add returnsOnlyFailures option into run_tests tool by @nowsprinting in #23
• Add timeout settings for the WebSocket and the test execution. by @nowsprinting in #22

Fixed

• Fix server auto-restart logic on domain reloading by @nowsprinting in #25
• Fix run_tests tool to properly run all tests on the given test mode and filter. Returning the tests result state
• Fix the get_tests resource to properly obtain all tests info without result state

Full Changelog: 1.0.1...1.0.2

Release 1.0.1

What's Changed

Fixed

• Fix run_tests response by @nowsprinting in #20
• Fix the auto-restart the server after domain reload triggered by a compilation trigger in unity, response in the issue #18

New Contributors

• @nowsprinting made their first contribution in #20

Full Changelog: 1.0.0...1.0.1

Release 1.0.0

First public production ready release for [MCP Unity], an implementation of the Model Context Protocol for Unity Editor, allowing AI assistants to interact with your Unity projects. This package provides a bridge between Unity and a Node.js server that implements the MCP protocol, enabling AI agents like Claude, Windsurf, and Cursor to execute operations within the Unity Editor.

Features

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:

• Improves code intelligence for Unity packages
• Enables better autocompletion and type information for Unity packages
• Helps AI coding assistants understand your project's dependencies

MCP Server Tools

• 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"

• select_gameobject: Selects game objects in the Unity hierarchy by path or instance ID

  Example prompt: "Select the Main Camera object in my scene"

• 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"

• add_package: Installs new packages in the Unity Package Manager

  Example prompt: "Add the TextMeshPro package to my project"

• run_tests: Runs tests using the Unity Test Runner

  Example prompt: "Run all the EditMode tests in my project"

• 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

• 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"

• unity://hierarchy: Retrieves a list of all game objects in the Unity hierarchy

  Example prompt: "Show me the current scene hierarchy structure"

• 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"

• unity://logs: Retrieves a list of all logs from the Unity console

  Example prompt: "Show me the recent error messages from the Unity console"

• 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"

• unity://assets: Retrieves information about assets in the Unity Asset Database

  Example prompt: "Find all texture assets in my project"

• unity://tests/{testMode}: Retrieves information about tests in the Unity Test Runner

  Example prompt: "List all available tests in my Unity project"

Contributors

• @smithery-ai made their first contribution in #1
• @punkpeye made their first contribution in #7

Full Changelog: https://github.com/CoderGamester/mcp-unity/commits/1.0.0