mcp-unity

# MCP Unity Editor (Game Engine) [](https://modelcontextprotocol.io/introduction) [](https://unity.com/releases/editor/archive) [](https://nodejs.org/en/download/) [](https://github.com/CoderGamester/mcp-unity/stargazers) [](https://github.com/CoderGamester/mcp-unity/commits/main) [](https://opensource.org/licenses/MIT) | [🇺🇸English](README.md) | [🇨🇳简体中文](README_zh-CN.md) | [🇯🇵日本語](README-ja.md) | |----------------------|---------------------------------|----------------------| ``` ,/(/. *(/, */(((((/. *((((((*. .*((((((((((/. *((((((((((/. ./((((((((((((((/ *((((((((((((((/, ,/(((((((((((((/*. */(((((((((((((/*. ,%%#((/((((((* ,/(((((/(#&@@( ,%%##%%##((((((/*. ,/((((/(#&@@@@@@( ,%%######%%##((/(((/*. .*/(((//(%@@@@@@@@@@@( ,%%####%#(%%#%%##((/((((((((//#&@@@@@@&@@@@@@@@( ,%%####%( /#%#%%%##(//(#@@@@@@@%, #@@@@@@@( ,%%####%( *#%###%@@@@@@( #@@@@@@@( ,%%####%( #%#%@@@@, #@@@@@@@( ,%%##%%%( #%#%@@@@, #@@@@@@@( ,%%%#* #%#%@@@@, *%@@@( ., ,/##*. #%#%@@@@, ./&@#* *` ,/#%#####%%#/, #%#%@@@@, ,/&@@@@@@@@@&\. `*#########%%%%###%@@@@@@@@@@@@@@@@@@&*´ `*%%###########%@@@@@@@@@@@@@@&*´ `*%%%######%@@@@@@@@@@&*´ `*#%%##%@@@@@&*´ `*%#%@&*´ ███╗ ███╗ ██████╗██████╗ ██╗ ██╗███╗ ██╗██╗████████╗██╗ ██╗ ████╗ ████║██╔════╝██╔══██╗ ██║ ██║████╗ ██║██║╚══██╔══╝╚██╗ ██╔╝ ██╔████╔██║██║ ██████╔╝ ██║ ██║██╔██╗ ██║██║ ██║ ╚████╔╝ ██║╚██╔╝██║██║ ██╔═══╝ ██║ ██║██║╚██╗██║██║ ██║ ╚██╔╝ ██║ ╚═╝ ██║╚██████╗██║ ╚██████╔╝██║ ╚████║██║ ██║ ██║ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═╝ ╚═╝ ``` MCP Unity is 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 The following tools are available for manipulating and querying Unity scenes and GameObjects via MCP: - `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_gameobject`: Updates a GameObject's core properties (name, tag, layer, active/static state), or creates the GameObject if it does not exist > **Example prompt:** "Set the Player object's tag to 'Enemy' and make it inactive" - `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 proje