Loading...
MCP Unity Editor enables AI assistants to interact with Unity projects, offering tools for scene manipulation, package management, and more, via a Node.js server.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
MCP Unity Editor enables AI assistants to interact with Unity projects, offering tools for scene manipulation, package management, and more, via a Node.js server.
MCP Unity provides useful tools for automating Unity tasks, but the ability to modify scenes, install packages, and execute menu items introduces moderate risk. It is safest when used with careful prompt engineering and a clear understanding of the potential side effects of each tool. Risky scenarios involve complex batch operations or poorly validated prompts that could lead to unintended modifications or instability.
Performance will be limited by the speed of the Node.js server and the Unity editor's API. Batch operations can improve efficiency by reducing the number of round trips between the server and the editor.
The primary cost considerations are the computational resources required to run the Node.js server and the Unity editor. There may also be costs associated with using AI assistants that interact with the MCP Unity server.
brew install node@18{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": [
"ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
]
}
}
}LOGGINGLOGGING_FILEexecute_menu_itemExecutes a specified menu item within the Unity Editor.
Could trigger unexpected or unwanted actions depending on the menu item.
select_gameobjectSelects a GameObject in the Unity hierarchy.
Read-only operation that does not modify the project.
update_gameobjectUpdates core properties of a GameObject or creates it if it doesn't exist.
Modifies GameObject properties, potentially altering scene behavior.
update_componentUpdates component fields on a GameObject or adds a component if it doesn't exist.
Modifies GameObject components, potentially altering scene behavior.
add_packageInstalls a new package in the Unity Package Manager.
Could introduce malicious or unstable dependencies.
run_testsRuns tests using the Unity Test Runner.
Executes tests, but does not modify project files.
send_console_logSends a log message to the Unity console.
Non-destructive operation that only outputs to the console.
add_asset_to_sceneAdds an asset from the AssetDatabase to the Unity scene.
Modifies the scene by adding an asset.
create_prefabCreates a prefab with an optional MonoBehaviour script.
Creates new assets in the project.
create_sceneCreates a new scene and saves it to the specified path.
Creates new assets in the project.
load_sceneLoads a scene by path or name.
Loads a scene, but does not modify project files.
delete_sceneDeletes a scene by path or name and removes it from Build Settings.
Deletes a scene file from the project.
get_gameobjectGets detailed information about a specific GameObject.
Read-only operation that does not modify the project.
get_console_logsRetrieves logs from the Unity console.
Read-only operation that does not modify the project.
recompile_scriptsRecompiles all scripts in the Unity project.
Can cause temporary instability or errors during recompilation.
save_sceneSaves the current active scene.
Modifies the current scene file.
get_scene_infoGets information about the active scene.
Read-only operation that does not modify the project.
unload_sceneUnloads a scene from the hierarchy.
Unloads a scene, but does not modify project files.
duplicate_gameobjectDuplicates a GameObject in the scene.
Modifies the scene by adding a new GameObject.
delete_gameobjectDeletes a GameObject from the scene.
Deletes a GameObject from the scene.
reparent_gameobjectChanges the parent of a GameObject in the hierarchy.
Modifies the scene hierarchy.
move_gameobjectMoves a GameObject to a new position.
Modifies the scene by changing GameObject positions.
rotate_gameobjectRotates a GameObject to a new rotation.
Modifies the scene by changing GameObject rotations.
scale_gameobjectScales a GameObject to a new local scale.
Modifies the scene by changing GameObject scales.
set_transformSets position, rotation, and scale of a GameObject in a single operation.
Modifies the scene by changing GameObject transforms.
create_materialCreates a new material with specified shader.
Creates new assets in the project.
assign_materialAssigns a material to a GameObject's Renderer component.
Modifies the appearance of a GameObject.
modify_materialModifies properties of an existing material.
Modifies the properties of a material.
get_material_infoGets detailed information about a material.
Read-only operation that does not modify the project.
batch_executeExecutes multiple tool operations in a single batch request.
Combines multiple operations, increasing the potential for unintended consequences.
None
cloud
MCP Unity provides useful tools for automating Unity tasks, but the ability to modify scenes, install packages, and execute menu items introduces moderate risk. It is safest when used with careful prompt engineering and a clear understanding of the potential side effects of each tool. Risky scenarios involve complex batch operations or poorly validated prompts that could lead to unintended modifications or instability.
Autonomy is highly dependent on the AI agent and the prompts provided. The system itself does not enforce strict sandboxing, so careful prompt engineering is crucial to prevent unintended actions.
Production Tip
Implement thorough testing and validation procedures for any automated workflows before deploying them to a production environment. Use the batch execution tool with rollback support to minimize the risk of data loss or corruption.
Unity 6 or later is required.
Yes, you need to install the MCP Unity package in your Unity project.
You need to configure your AI assistant to communicate with the Node.js server using the Model Context Protocol.
Yes, but you will need to ensure that the Node.js server is accessible from the cloud environment.
You can control the actions by carefully crafting the prompts and potentially implementing custom validation logic on the server side.
You can use Node.js debugging tools to inspect the server's code and logs. Unity's console also provides valuable information.
Yes, MCP Unity works well with Git. However, be mindful of large scene files and consider using Git LFS.