Unity MCP Package

What is Unity MCP Package?

A Unity package that enables bidirectional communication between Unity and Large Language Models (LLMs) via the Model Context Protocol (MCP). It acts as a bridge for sending commands and receiving responses from MCP-compliant tools, with current focus on enhanced material editing. The package is under active development with planned features including lighting effects, physics integration, and terrain enhancements.

How to use Unity MCP Package?

Install Python 3.12 or newer with uv package manager, then add the package from git URL https://github.com/HuangChILun/reavorse-mcp.git via Unity’s Package Manager. The server starts automatically when used with an MCP client like Claude Desktop or Cursor.

Key features of Unity MCP Package

• Bidirectional communication between Unity and LLMs.
• Programmatic asset creation, import, and manipulation.
• Scene control: open, save, modify scenes and objects.
• Enhanced material editing with advanced lighting and shaders.
• Script integration: create, view, and update C# scripts.
• Editor automation: undo, redo, play mode, and build processes.

Use cases of Unity MCP Package

• Automate repetitive Unity Editor tasks via natural language commands.
• Programmatically manage assets, scenes, and materials with LLM guidance.
• Integrate AI into Unity workflows for rapid prototyping and iteration.
• Enhance material properties and lighting without manual shader coding.

FAQ from Unity MCP Package

What are the system requirements?

Unity 2020.3 LTS or newer, Python 3.12 or newer, the uv package manager, and a URP project. Only URP projects are currently supported.

How do I troubleshoot a connection failure?

Ensure the Unity Editor is open and the MCP window is active. Verify Python and uv are correctly installed and the Unity MCP package is properly set up. Restart Unity if needed.

How to configure an MCP client?

Your MCP client (e.g., Claude Desktop, Cursor) must be configured to communicate with the Unity MCP server. Refer to the client’s documentation for MCP configuration details.

Why is the process stuck with no progress?

Close both the MCP client (e.g., Claude) and the Unity project, then reconnect to re-establish the connection.

Where can I get help or report issues?

Contact the maintainer on X at @reavorse for questions or feedback.