You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Rename namespace and public facing plugin output from "Unity MCP" to "MCP for Unity" (#225)
* refactor: rename namespace from UnityMcpBridge to MCPForUnity across all files
See thread in #6, we can't use Unity MCP because it violates their trademark.
That name makes us look affiliated. We can use MCP for Unity
* Change package display name, menu item and menu titles
These are front facing so has to change for Unity asset store review
* Misc name changes in logs and comments for better consistency
* chore: update editor window title from 'MCP Editor' to 'MCP for Unity'
* refactor: update branding from UNITY-MCP to MCP-FOR-UNITY across all log messages and warnings
* chore: rename Unity MCP to MCP For Unity across all files and bump version to 2.1.2
* docs: update restore script title to clarify Unity MCP naming
* Fix usage instructions
* chore: update log messages to use MCP For Unity branding instead of UnityMCP
* Add a README inside plugin, required for distributing via the asset store
* docs: update Unity port description and fix typo in troubleshooting section
* Address Rabbit feedback
* Update Editor prefs to use new name
Prevents overlap with other Unity MCPs, happy to revert if it's too much
* refactor: rename server logger and identifier from unity-mcp-server to mcp-for-unity-server
* Standardize casing of renamed project to "MCP for Unity", as it is on the asset store
* Remove unused folder
* refactor: rename Unity MCP to MCP for Unity across codebase
* Update dangling references
* docs: update product name from UnityMCP to MCP for Unity in README
* Update log and comments for new name
Copy file name to clipboardExpand all lines: CursorHelp.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
### Cursor/VSCode/Windsurf: UV path issue on Windows (diagnosis and fix)
2
2
3
3
#### The issue
4
-
- Some Windows machines have multiple `uv.exe` locations. Our auto-config sometimes picked a less stable path, causing the MCP client to fail to launch the Unity MCP Server or for the path to be auto-rewritten on repaint/restart.
4
+
- Some Windows machines have multiple `uv.exe` locations. Our auto-config sometimes picked a less stable path, causing the MCP client to fail to launch the MCP for Unity Server or for the path to be auto-rewritten on repaint/restart.
5
5
6
6
#### Typical symptoms
7
-
- Cursor shows the UnityMCP server but never connects or reports it “can’t start.”
8
-
- Your `%USERPROFILE%\\.cursor\\mcp.json` flips back to a different `command` path when Unity or the Unity MCP window refreshes.
7
+
- Cursor shows the MCP for Unity server but never connects or reports it “can’t start.”
8
+
- Your `%USERPROFILE%\\.cursor\\mcp.json` flips back to a different `command` path when Unity or the MCP for Unity window refreshes.
3) If uv is already found but wrong, still click “Choose UV Install Location” and select the `Links\uv.exe` path above. This saves a persistent override.
21
+
3) If uv is already found but wrong, still click “Choose `uv` Install Location” and select the `Links\uv.exe` path above. This saves a persistent override.
22
22
4) Click “Auto Configure” (or re-open the client) and restart Cursor.
23
23
24
-
This sets an override stored in the Editor (key: `UnityMCP.UvPath`) so UnityMCP won’t auto-rewrite the config back to a different `uv.exe` later.
24
+
This sets an override stored in the Editor (key: `MCPForUnity.UvPath`) so MCP for Unity won’t auto-rewrite the config back to a different `uv.exe` later.
25
25
26
26
#### Verify the fix
27
27
- Confirm global Cursor config is at: `%USERPROFILE%\\.cursor\\mcp.json`
@@ -71,8 +71,8 @@ If that runs without error, restart Cursor and it should connect.
71
71
72
72
Recommended practice
73
73
74
-
- Prefer the WinGet Links shim paths above. If present, select one via “Choose UV Install Location”.
75
-
- If the unity window keeps rewriting to a different `uv.exe`, pick the Links shim again; Unity MCP saves a pinned override and will stop auto-rewrites.
74
+
- Prefer the WinGet Links shim paths above. If present, select one via “Choose `uv` Install Location”.
75
+
- If the unity window keeps rewriting to a different `uv.exe`, pick the Links shim again; MCP for Unity saves a pinned override and will stop auto-rewrites.
76
76
- If neither Links path exists, a reasonable fallback is `~/.local/bin/uv.exe` (uv tools bin) or a Scoop shim, but Links is preferred for stability.
3. Right click the package and choose "Show in Explorer"
65
65
4. That opens the exact cache folder Unity is using for your project
66
66
@@ -77,7 +77,7 @@ Note: In recent builds, the Python server sources are also bundled inside the pa
77
77
78
78
## Switching MCP package sources quickly
79
79
80
-
Use `mcp_source.py` to quickly switch between different Unity MCP package sources:
80
+
Use `mcp_source.py` to quickly switch between different MCP for Unity package sources:
81
81
82
82
**Usage:**
83
83
```bash
@@ -96,7 +96,7 @@ After switching, open Package Manager and Refresh to re-resolve packages.
96
96
97
97
### "Path not found" errors running the .bat file
98
98
- Verify Unity package cache path is correct
99
-
- Check that Unity MCP package is actually installed
99
+
- Check that MCP for Unity package is actually installed
100
100
- Ensure server is installed via MCP client
101
101
102
102
### "Permission denied" errors
@@ -110,4 +110,4 @@ After switching, open Package Manager and Refresh to re-resolve packages.
110
110
- Verify backup directory path is correct
111
111
112
112
### Windows uv path issues
113
-
- On Windows, when testing GUI clients, prefer the WinGet Links `uv.exe`; if multiple `uv.exe` exist, use "Choose UV Install Location" to pin the Links shim.
113
+
- On Windows, when testing GUI clients, prefer the WinGet Links `uv.exe`; if multiple `uv.exe` exist, use "Choose `uv` Install Location" to pin the Links shim.
Copy file name to clipboardExpand all lines: README.md
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# Unity MCP ✨
1
+
# MCP for Unity ✨
2
2
3
3
#### Proudly sponsored and maintained by [Coplay](https://www.coplay.dev/?ref=unity-mcp), the AI assistant for Unity. [Read the backstory here.](https://www.coplay.dev/blog/coplay-and-open-source-unity-mcp-join-forces)
4
4
@@ -13,13 +13,13 @@
13
13
14
14
**Create your Unity apps with LLMs!**
15
15
16
-
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.
16
+
MCP for Unity 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.
17
17
18
18
## 💬 Join Our Community
19
19
20
20
### [Discord](https://discord.gg/y4p8KfzrN4)
21
21
22
-
**Get help, share ideas, and collaborate with other Unity MCP developers!**
22
+
**Get help, share ideas, and collaborate with other MCP for Unity developers!**
23
23
24
24
---
25
25
@@ -49,12 +49,12 @@ Unity MCP acts as a bridge, allowing AI assistants (like Claude, Cursor) to inte
49
49
50
50
## How It Works 🤔
51
51
52
-
Unity MCP connects your tools using two components:
52
+
MCP for Unity connects your tools using two components:
53
53
54
-
1.**Unity MCP Bridge:** A Unity package running inside the Editor. (Installed via Package Manager).
55
-
2.**Unity MCP Server:** A Python server that runs locally, communicating between the Unity Bridge and your MCP Client. (Installed manually).
54
+
1.**MCP for Unity Bridge:** A Unity package running inside the Editor. (Installed via Package Manager).
55
+
2.**MCP for Unity Server:** A Python server that runs locally, communicating between the Unity Bridge and your MCP Client. (Installed automatically by the package on first run or via Auto-Setup; manual setup is available as a fallback).
56
56
57
-
**Flow:**`[Your LLM via MCP Client] <-> [Unity MCP Server (Python)] <-> [Unity MCP Bridge (Unity Editor)]`
57
+
**Flow:**`[Your LLM via MCP Client] <-> [MCP for Unity Server (Python)] <-> [MCP for Unity Bridge (Unity Editor)]`
58
58
59
59
---
60
60
@@ -111,7 +111,7 @@ Unity MCP connects your tools using two components:
- **VSCode**: uses `Code/User/mcp.json` with top-level `servers.unityMCP` and `"type": "stdio"`. On Windows, Unity MCP writes an absolute `uv.exe` (prefers WinGet Links shim) to avoid PATH issues.
139
-
- **Cursor / Windsurf** [(**help link**)](https://github.com/CoplayDev/unity-mcp/wiki/1.-Fix-Unity-MCP-and-Cursor,-VSCode-&-Windsurf): if`uv` is missing, the Unity MCP window shows "uv Not Found" with a quick [HELP] link and a "Choose UV Install Location" button.
138
+
- **VSCode**: uses `Code/User/mcp.json` with top-level `servers.unityMCP` and `"type": "stdio"`. On Windows, MCPfor Unity writes an absolute `uv.exe` (prefers WinGet Links shim) to avoid PATH issues.
139
+
- **Cursor / Windsurf** [(**help link**)](https://github.com/CoplayDev/unity-mcp/wiki/1.-Fix-Unity-MCP-and-Cursor,-VSCode-&-Windsurf): if`uv` is missing, the MCP for Unity window shows "uv Not Found" with a quick [HELP] link and a "Choose `uv` Install Location" button.
140
140
- **Claude Code** [(**help link**)](https://github.com/CoplayDev/unity-mcp/wiki/2.-Fix-Unity-MCP-and-Claude-Code): if`claude` isn't found, the window shows "Claude Not Found" with [HELP] and a "Choose Claude Location" button. Unregister now updates the UI immediately.</details>
141
141
142
142
@@ -252,9 +252,9 @@ claude mcp add UnityMCP -- "C:/Users/USERNAME/AppData/Roaming/Python/Python313/S
252
252
253
253
## Usage ▶️
254
254
255
-
1. **Open your Unity Project.** The Unity MCP Bridge (package) should connect automatically. Check status via Window >Unity MCP.
255
+
1. **Open your Unity Project.** The MCP for Unity package should connect automatically. Check status via Window > MCPfor Unity.
256
256
257
-
2. **Start your MCP Client** (Claude, Cursor, etc.). It should automatically launch the Unity MCP Server (Python) using the configuration from Installation Step 3.
257
+
2. **Start your MCP Client** (Claude, Cursor, etc.). It should automatically launch the MCP for Unity Server (Python) using the configuration from Installation Step 2.
258
258
259
259
3. **Interact!** Unity tools should now be available in your MCP Client.
260
260
@@ -304,9 +304,9 @@ claude mcp add UnityMCP -- "C:/Users/USERNAME/AppData/Roaming/Python/Python313/S
304
304
305
305
### Development Tools
306
306
307
-
If you\'re contributing to Unity MCP or want to test core changes, we have development tools to streamline your workflow:
307
+
If you\'re contributing to MCPfor Unity or want to test core changes, we have development tools to streamline your workflow:
308
308
309
-
- **Development Deployment Scripts**: Quickly deploy and test your changes to Unity MCP Bridge and Python Server
309
+
- **Development Deployment Scripts**: Quickly deploy and test your changes to MCPfor Unity Bridge and Python Server
310
310
- **Automatic Backup System**: Safe testing with easy rollback capabilities
311
311
- **Hot Reload Workflow**: Fast iteration cycle for core development
312
312
- **More coming!**
@@ -315,7 +315,7 @@ If you\'re contributing to Unity MCP or want to test core changes, we have devel
315
315
316
316
### Contributing 🤝
317
317
318
-
Help make Unity MCP better!
318
+
Help make MCPfor Unity better!
319
319
320
320
1. **Fork** the main repository.
321
321
@@ -338,7 +338,7 @@ Help make Unity MCP better!
338
338
339
339
- **Unity Bridge Not Running/Connecting:**
340
340
- Ensure Unity Editor is open.
341
-
- Check the status window: Window >Unity MCP.
341
+
- Check the status window: Window > MCPfor Unity.
342
342
- Restart Unity.
343
343
- **MCP Client Not Connecting / Server Not Starting:**
344
344
- **Verify Server Path:** Double-check the --directory path in your MCP Client\'s JSON config. It must exactly match the location where you cloned the UnityMCP repository in Installation Step 1 (e.g., .../Programs/UnityMCP/UnityMcpServer/src).
0 commit comments