From fb8be3b1c59bd967fdd8f36c09bfdddd5479183e Mon Sep 17 00:00:00 2001 From: Shutong Wu <51266340+Scriptwonder@users.noreply.github.com> Date: Sun, 13 Jul 2025 15:14:08 -0400 Subject: [PATCH 1/3] Update ManageAsset.cs --- UnityMcpBridge/Editor/Tools/ManageAsset.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/UnityMcpBridge/Editor/Tools/ManageAsset.cs b/UnityMcpBridge/Editor/Tools/ManageAsset.cs index a9eeae24..5a27de01 100644 --- a/UnityMcpBridge/Editor/Tools/ManageAsset.cs +++ b/UnityMcpBridge/Editor/Tools/ManageAsset.cs @@ -907,9 +907,9 @@ private static bool ApplyMaterialProperties(Material mat, JObject properties) ); } } - } else if (properties["_Color"] is JArray colorArr) //Current Prevention for systems that use _Color instead of color + } else if (properties["color"] is JArray colorArr) //Current Prevention for systems that use _Color instead of color { - string propName = "_Color"; // Default main color + string propName = "_Color"; try { if (colorArr.Count >= 3) { From e5793a63472abc9e2bfb6ffa174656208d88c7cc Mon Sep 17 00:00:00 2001 From: Scriptwonder <1300285021@qq.com> Date: Sun, 13 Jul 2025 16:06:32 -0400 Subject: [PATCH 2/3] Update on Readme and TODO --- README.md | 29 +++++++++++++++++++--- UnityMcpBridge/Editor/Tools/ManageAsset.cs | 2 +- 2 files changed, 27 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index e422540e..64ce3e7c 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,6 @@ Unity MCP acts as a bridge, allowing AI assistants (like Claude, Cursor) to inte --- -## UnityMCP Workflow ## Key Features 🚀 @@ -62,6 +61,7 @@ Unity MCP connects your tools using two components: * **An MCP Client:** * [Claude Desktop](https://claude.ai/download) * [Cursor](https://www.cursor.com/en/downloads) + * [Visual Studio Code Copilot](https://code.visualstudio.com/docs/copilot/overview) * *(Others may work with manual config)* @@ -84,7 +84,7 @@ Connect your MCP Client (Claude, Cursor, etc.) to the Python server you installe **Option A: Auto-Configure (Recommended for Claude/Cursor)** 1. In Unity, go to `Window > Unity MCP`. -2. Click `Auto Configure Claude` or `Auto Configure Cursor`. +2. Click `Auto Configure` on the IDE you uses. 3. Look for a green status indicator 🟢 and "Connected". *(This attempts to modify the MCP Client's config file automatically)*. **Option B: Manual Configuration** @@ -175,6 +175,28 @@ If Auto-Configure fails or you use a different client: Example Prompt: `Create a 3D player controller.` +--- + +## TODOs (Besides PR) 📝 +### High Priority +- [ ] **AssetsGeneration Improvements** - Better server request handling +- [ ] **CodeGeneration Improvements** - Better generated code handling +- [ ] **Error Handling Improvements** - Better error messages and recovery mechanisms +- [ ] **Remote Connection** - Enable remote connection between host and server +- [ ] **Documentation Expansion** - Add tutorials on how to add your own tools + +### Medium Priority +- [ ] **Custom Tool Creation** - GUI for users to create their own MCP tools +- [ ] **Logging System** - Comprehensive logging for debugging and monitoring + +### Low Priority +- [ ] **Mobile Platform Support** - Extended tools for mobile development workflows +- [ ] **Easier Setup** + +### Research & Exploration +- [ ] **AI-Powered Asset Generation** - Integration with AI tools for automatic asset creation +- [ ] **Real-time Collaboration** - Live editing sessions between multiple developers (Currently ongoing) +- [ ] **Analytics Dashboard** - Usage analytics and project insights --- @@ -239,7 +261,8 @@ MIT License. See [LICENSE](https://www.google.com/url?sa=E&q=https%3A%2F%2Fgithu ## Contact 👋 -- **X/Twitter:** [@justinpbarnett](https://www.google.com/url?sa=E&q=https%3A%2F%2Fx.com%2Fjustinpbarnett) +- **justinpbarnett:** [X/Twitter](https://www.google.com/url?sa=E&q=https%3A%2F%2Fx.com%2Fjustinpbarnett) +- **scriptwonder**: [Email](mailto:swu85@ur.rochester.edu), [LinkedIn](https://www.linkedin.com/in/shutong-wu-214043172/) --- diff --git a/UnityMcpBridge/Editor/Tools/ManageAsset.cs b/UnityMcpBridge/Editor/Tools/ManageAsset.cs index 5a27de01..432b234b 100644 --- a/UnityMcpBridge/Editor/Tools/ManageAsset.cs +++ b/UnityMcpBridge/Editor/Tools/ManageAsset.cs @@ -907,7 +907,7 @@ private static bool ApplyMaterialProperties(Material mat, JObject properties) ); } } - } else if (properties["color"] is JArray colorArr) //Current Prevention for systems that use _Color instead of color + } else if (properties["color"] is JArray colorArr) //Use color now with examples set in manage_asset.py { string propName = "_Color"; try { From 6665eac5151c7e4caf8e056222513dd534b89f29 Mon Sep 17 00:00:00 2001 From: Scriptwonder <1300285021@qq.com> Date: Sun, 13 Jul 2025 16:29:58 -0400 Subject: [PATCH 3/3] Readme update with badges and more --- README.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 64ce3e7c..59774098 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,17 @@ # Unity MCP ✨ -**Connect your Unity Editor to LLMs using the Model Context Protocol.** + +[![](https://img.shields.io/badge/Unity-000000?style=flat&logo=unity&logoColor=blue 'Unity')](https://unity.com/releases/editor/archive) +[![python](https://img.shields.io/badge/Python-3.12-3776AB.svg?style=flat&logo=python&logoColor=white)](https://www.python.org) +[![](https://badge.mcpx.dev?status=on 'MCP Enabled')](https://modelcontextprotocol.io/introduction) +![GitHub commit activity](https://img.shields.io/github/commit-activity/w/justinpbarnett/unity-mcp) +![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/justinpbarnett/unity-mcp) +[![](https://img.shields.io/badge/License-MIT-red.svg 'MIT License')](https://opensource.org/licenses/MIT) + + + + +**Create your Unity apps with LLMs!** Unity MCP acts as a bridge, allowing AI assistants (like Claude, Cursor) to interact directly with your Unity Editor via a local **MCP (Model Context Protocol) Client**. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity. @@ -47,8 +58,6 @@ Unity MCP connects your tools using two components: ### Prerequisites -
- Click to view required software... * **Git CLI:** For cloning the server code. [Download Git](https://git-scm.com/downloads) * **Python:** Version 3.12 or newer. [Download Python](https://www.python.org/downloads/) @@ -63,7 +72,6 @@ Unity MCP connects your tools using two components: * [Cursor](https://www.cursor.com/en/downloads) * [Visual Studio Code Copilot](https://code.visualstudio.com/docs/copilot/overview) * *(Others may work with manual config)* -
### Step 1: Install the Unity Package (Bridge) @@ -183,7 +191,7 @@ If Auto-Configure fails or you use a different client: - [ ] **CodeGeneration Improvements** - Better generated code handling - [ ] **Error Handling Improvements** - Better error messages and recovery mechanisms - [ ] **Remote Connection** - Enable remote connection between host and server -- [ ] **Documentation Expansion** - Add tutorials on how to add your own tools +- [ ] **Documentation Expansion** - Add tutorials on how to add your own tools, and documentation on existing tools and functions ### Medium Priority - [ ] **Custom Tool Creation** - GUI for users to create their own MCP tools @@ -249,7 +257,7 @@ Help make Unity MCP better! -Still stuck? [Open an Issue](https://www.google.com/url?sa=E&q=https%3A%2F%2Fgithub.com%2Fjustinpbarnett%2Funity-mcp%2Fissues). +Still stuck? [Open an Issue](https://www.google.com/url?sa=E&q=https%3A%2F%2Fgithub.com%2Fjustinpbarnett%2Funity-mcp%2Fissues) or [Join the Discord](https://discord.gg/vhTUxXaqYr)! --- @@ -270,3 +278,8 @@ MIT License. See [LICENSE](https://www.google.com/url?sa=E&q=https%3A%2F%2Fgithu ## Acknowledgments 🙏 Thanks to the contributors and the Unity team. + + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=unity-mcp/unity-mcp,justinpbarnett/unity-mcp&type=Date)](https://www.star-history.com/#unity-mcp/unity-mcp&justinpbarnett/unity-mcp&Date)