Skip to content
Back to search

advanced-unity-mcp

Public repository for Advanced Unity MCP by Code Maestro (www.code-maestro.com).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/codemaestroai--advanced-unity-mcp/badge.svg)](/listings/codemaestroai--advanced-unity-mcp)

HTML

<a href="/listings/codemaestroai--advanced-unity-mcp"><img src="/api/listings/codemaestroai--advanced-unity-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**1. Install the Package**

Unity Package Manager → Add package from git URL for the version of Unity you are using

For **Unity 2020-2022**

https://github.com/codemaestroai/advanced-unity-mcp.git?path=Unity2020_2022

For **Unity 6+**

https://github.com/codemaestroai/advanced-unity-mcp.git?path=Unity6

**2. Connect Your AI** - Go to `Code Maestro > MCP Dashboard` in Unity. - **For Code Maestro Desktop App:** Select the "Code Maestro Desktop App" connection mode. The connection is automatic, and the dashboard will show the connection status. - **For other clients (VS Code, Cursor, etc.):** Select the "Other Clients" connection mode, then click **Configure** next to your preferred client. - Start giving commands!

**Supported MCP Clients:** - **Code Maestro Desktop App** (uses Direct Connection) - **GitHub Copilot (VS Code)** - **Cursor** - **Windsurf** - **Claude Desktop** - ...and any other MCP-capable copilot.

*Clients other than the Code Maestro Desktop App use the Relay Server connection, which is installed automatically.*

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 89 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Advanced Unity MCP from Code Maestro
  2. **Control Unity with AI through natural language commands.**
  3. Instead of clicking through menus and manually setting up GameObjects, just tell your AI assistant what you want and watch it happen automatically.
  4. ```
  5. "Create a red material and apply it to a cube"
  6. "Build the project for Android"
  7. "Make a new scene with a camera and directional light"
  8. ```
  9. **Watch the video**
  10. [![Watch the video](http://img.youtube.com/vi/EwBuDHmiHMA/0.jpg)](http://www.youtube.com/watch?v=EwBuDHmiHMA "Advanced MCP Integration for Unity - Powered by Code Maestro (Coming Soon)")
  11. ## Quick Start
  12. **1. Install the Package**
  13. Unity Package Manager → Add package from git URL for the version of Unity you are using
  14. For **Unity 2020-2022**
  15. ```
  16. https://github.com/codemaestroai/advanced-unity-mcp.git?path=Unity2020_2022
  17. ```
  18. For **Unity 6+**
  19. ```
  20. https://github.com/codemaestroai/advanced-unity-mcp.git?path=Unity6
  21. ```
  22. **2. Connect Your AI**
  23. - Go to `Code Maestro > MCP Dashboard` in Unity.
  24. - **For Code Maestro Desktop App:** Select the "Code Maestro Desktop App" connection mode. The connection is automatic, and the dashboard will show the connection status.
  25. - **For other clients (VS Code, Cursor, etc.):** Select the "Other Clients" connection mode, then click **Configure** next to your preferred client.
  26. - Start giving commands!
  27. **Supported MCP Clients:**
  28. - **Code Maestro Desktop App** (uses Direct Connection)
  29. - **GitHub Copilot (VS Code)**
  30. - **Cursor**
  31. - **Windsurf**
  32. - **Claude Desktop**
  33. - ...and any other MCP-capable copilot.
  34. *Clients other than the Code Maestro Desktop App use the Relay Server connection, which is installed automatically.*
  35. ## What Unity MCP Can Do
  36. **Core Editor Control** - Play/pause/stop game, execute menu items, read/clear console messages
  37. **Asset & Scene Management** - Create/modify/delete materials, prefabs, scripts, manage scenes and GameObjects
  38. **Build & Platform Tools** - Build settings, platform switching, Android Debug Bridge operations
  39. **Project Configuration** - Unity packages, project settings, PlayerPrefs, external tools
  40. **Performance Analysis** - Unity Profiler control for performance bottlenecks
  41. ## Examples
  42. - `"Check the console for any errors"`
  43. - `"Create a script called PlayerMovement with WASD controls"`
  44. - `"Switch the build target to iOS"`
  45. - `"Add a rigidbody component to the selected object"`
  46. - `"Create a new material with metallic properties"`
  47. - `"Save the current GameObject as a prefab"`
  48. - `"Clear all console messages and check for warnings"`
  49. ## How It Works
  50. Unity MCP bridges your Unity Editor with AI assistants using the Model Context Protocol. It supports two connection modes, which can be selected in the MCP Dashboard:
  51. - **Direct Connection (for Code Maestro Desktop App):** This is the recommended mode for Code Maestro users. The Unity Editor connects directly to the Code Maestro Desktop App's central hub. This method is faster and doesn't require a separate relay server.
  52. - **Unity MCP Connector:** Runs inside the Unity Editor to manage the connection.
  53. - **Relay Server Connection (for other clients):** For clients like VS Code or Cursor, the bridge uses a local TCP server and a relay server.
  54. - **Bridge Server:** Runs in the Unity Editor and provides API access over a local TCP port.
  55. - **Relay Server:** A small background process that handles communication between the AI client and the Unity Bridge Server. It is installed automatically.
  56. The setup is automatic. Simply choose your connection mode in the dashboard.
  57. **💡 Tip:** When multiple Unity projects are open, your AI assistant will automatically connect to the most recently opened Unity Editor instance.
  58. ## Requirements
  59. - Unity 2022+
  60. - MCP Client (Such as GitHub Copilot or Cursor)
  61. ---
  62. **Made by [Code Maestro](https://www.code-maestro.com) • [Join our Discord](https://discord.gg/bsFRAqATXz) • [Report Issues](https://github.com/codemaestroai/advanced-unity-mcp/issues) • [License](./LICENSE)**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.