Switch MCP for Unity Package Source
You are switching the
package source in one or more Unity projects.
allowed-tools
Bash, Read, Edit, ReadMcpResourceTool, ListMcpResourcesTool
Instructions
1. Parse arguments
Valid values:
,
,
,
, or empty.
If empty or not one of the four valid values, ask the user to choose:
- main — upstream main branch (stable releases)
- beta — upstream beta branch (pre-release)
- branch — your current remote branch (for testing a PR)
- local — local file reference to your checkout (for live dev iteration)
2. Detect repo context
Run these git commands from the current working directory to find the unity-mcp repo:
bash
git rev-parse --show-toplevel # → repo_root
git rev-parse --abbrev-ref HEAD # → branch_name
git remote get-url origin # → origin_url
Convert SSH origins to HTTPS: if
starts with
, transform it to
https://github.com/{owner}/{repo}.git
.
3. Discover target Unity projects
Try two approaches to find
files to update:
Approach A — MCP resources (preferred):
Read
mcpforunity://project/info
for each connected Unity instance (use
to find available instances). Extract
and use
{projectRoot}/Packages/manifest.json
.
Approach B — filesystem fallback:
If no MCP instances are connected, search upward from the current working directory for
files using Bash:
bash
find "$(pwd)" -maxdepth 3 -name "manifest.json" -path "*/Packages/manifest.json" 2>/dev/null
If multiple manifests are found, update all of them (confirming with the user first).
4. Build the package URL
Based on the user's selection, construct the dependency value:
| Selection | URL |
|---|
| https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
|
| https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta
|
| {origin_https}?path=/MCPForUnity#{branch_name}
|
| file:{repo_root}/MCPForUnity
|
For
: use the HTTPS-normalized origin URL and current git branch name.
For
: use the absolute path to the repo root with
prefix (no
), e.g.
file:/Users/davidsarno/unity-mcp/MCPForUnity
.
5. Update each manifest
- Read the file with the Read tool
- Find the
"com.coplaydev.unity-mcp"
- Use the Edit tool to replace the old value with the new URL
- Report what was changed: old value → new value, file path
6. Report results
After updating, tell the user:
- Which manifests were updated
- The old and new package source values
- Remind them: "Unity will re-resolve the package automatically. If it doesn't, open Package Manager and click Refresh."