unity-mcp

unity-mcp

2,052
ai_chatbotdeveloper_tools

Unity MCP provides a bridge that allows AI assistants to connect and interact with the Unity Editor through the Model Context Protocol. It manages assets, controls scenes, and automates tasks, enhancing efficiency in Unity projects.

Unity MCP ✨

Connect your Unity Editor to LLMs using the Model Context Protocol.

Unity MCP acts as a bridge between AI assistants and your Unity Editor via a local MCP Client, enabling management of assets, scene control, script editing, and task automation.

Key Features 🚀

  • 🗣️ Natural Language Control: Perform Unity tasks through LLMs.
  • 🛠️ Powerful Tools: Manage assets, scenes, scripts, and editor functions.
  • 🤖 Automation: Automate Unity workflows.
  • 🧩 Extensible: Compatible with various MCP Clients.

How It Works 🤔

Unity MCP contains two components:

  1. Unity MCP Bridge: A Unity package.
  2. Unity MCP Server: A local Python server.

Flow: [Your LLM via MCP Client] <-> [Unity MCP Server (Python)] <-> [Unity MCP Bridge (Unity Editor)]

Usage ▶️

  1. Open your Unity Project.
  2. Start your MCP Client (e.g., Claude, Cursor).
  3. Interact with Unity tools through your MCP Client.

Troubleshooting ❓

  • If Unity Bridge is not connecting, ensure Unity Editor is open and check status window.
  • Verify server path and uv installation if the MCP Client is not connecting.

Contributing 🤝

  1. Fork the repository.
  2. Create a branch for changes.
  3. Make changes and open a Pull Request.