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 IDExample 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 componentExample prompt: "Add a Rigidbody component to the Player object and set its mass to 5"
-
add_package
: Installs new packages in the Unity Package ManagerExample prompt: "Add the TextMeshPro package to my project"
-
run_tests
: Runs tests using the Unity Test RunnerExample prompt: "Run all the EditMode tests in my project"
-
notify_message
: Displays messages in the Unity EditorExample 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 sceneExample 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 facilitateexecute_menu_item
toolExample prompt: "Show me all available menu items related to GameObject creation"
-
unity://hierarchy
: Retrieves a list of all game objects in the Unity hierarchyExample 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 fieldsExample prompt: "Get me detailed information about the Player GameObject"
-
unity://logs
: Retrieves a list of all logs from the Unity consoleExample prompt: "Show me the recent error messages from the Unity console"
-
unity://packages
: Retrieves information about installed and available packages from the Unity Package ManagerExample prompt: "List all the packages currently installed in my Unity project"
-
unity://assets
: Retrieves information about assets in the Unity Asset DatabaseExample prompt: "Find all texture assets in my project"
-
unity://tests/{testMode}
: Retrieves information about tests in the Unity Test RunnerExample 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