From b735210d9d48d2046ff66b07e0b06d965fd8e1dd Mon Sep 17 00:00:00 2001 From: Marcus Sanatan Date: Thu, 14 Aug 2025 18:13:21 -0400 Subject: [PATCH 1/7] Update required Unity version and package name Closes #213 --- README.md | 2 +- UnityMcpBridge/package.json | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index e132d9b2..17ee0fc9 100644 --- a/README.md +++ b/README.md @@ -65,7 +65,7 @@ Unity MCP connects your tools using two components: ### Prerequisites * **Python:** Version 3.12 or newer. [Download Python](https://www.python.org/downloads/) - * **Unity Hub & Editor:** Version 2020.3 LTS or newer. [Download Unity](https://unity.com/download) + * **Unity Hub & Editor:** Version 2021.3 LTS or newer. [Download Unity](https://unity.com/download) * **uv (Python package manager):** ```bash pip install uv diff --git a/UnityMcpBridge/package.json b/UnityMcpBridge/package.json index a5d06510..048a4755 100644 --- a/UnityMcpBridge/package.json +++ b/UnityMcpBridge/package.json @@ -1,9 +1,9 @@ { "name": "com.coplaydev.unity-mcp", "version": "2.1.1", - "displayName": "Unity MCP Bridge", - "description": "A bridge that manages and communicates with the sister application, Unity MCP Server, which allows for communications with MCP Clients like Claude Desktop or Cursor.", - "unity": "2020.3", + "displayName": "Unity MCP", + "description": "A bridge that connects an LLM to Unity via the MCP (Model Context Protocol). This allows MCP Clients like Claude Desktop or Cursor to directly control your Unity Editor.", + "unity": "2021.3", "documentationUrl": "https://github.com/CoplayDev/unity-mcp", "licensesUrl": "https://github.com/CoplayDev/unity-mcp/blob/main/LICENSE", "dependencies": { From 3fd59e3927221465f3cc58980c5e7347fb373a42 Mon Sep 17 00:00:00 2001 From: Marcus Sanatan Date: Thu, 14 Aug 2025 18:18:33 -0400 Subject: [PATCH 2/7] docs: add OpenUPM installation option --- README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 17ee0fc9..c75888c8 100644 --- a/README.md +++ b/README.md @@ -99,7 +99,9 @@ Unity MCP connects your tools using two components: **Note:** Without Roslyn, script validation falls back to basic structural checks. Roslyn enables full C# compiler diagnostics with precise error reporting. -### 🌟Step 1: Install the Unity Package (Bridge)🌟 +### 🌟Step 1: Install the Unity Package🌟 + +### To install via Git URL 1. Open your Unity project. 2. Go to `Window > Package Manager`. @@ -111,6 +113,12 @@ Unity MCP connects your tools using two components: 5. Click `Add`. 6. The MCP Server should automatically be installed onto your machine as a result of this process. +### To install via OpenUPM + +1. Instal the [OpenUPM CLI](https://openupm.com/docs/getting-started-cli.html) +2. Open a terminal (PowerShell, Terminal, etc.) and navigate to your Unity project directory +3. Run `openupm add com.coplaydev.unity-mcp` + **Note:** If you installed the MCP Server before Coplay's maintenance, you will need to uninstall the old package before re-installing the new one. ### Step 2: Configure Your MCP Client From 148fa8b431ea7c4198030d48b7a3c0cfdf869258 Mon Sep 17 00:00:00 2001 From: Marcus Sanatan Date: Thu, 14 Aug 2025 18:29:22 -0400 Subject: [PATCH 3/7] Bump version because we have a name change --- UnityMcpBridge/UnityMcpServer~/src/pyproject.toml | 2 +- UnityMcpBridge/package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml b/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml index 2c05fb83..5ecb1035 100644 --- a/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml +++ b/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "UnityMcpServer" -version = "2.0.0" +version = "2.1.2" description = "Unity MCP Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP)." readme = "README.md" requires-python = ">=3.10" diff --git a/UnityMcpBridge/package.json b/UnityMcpBridge/package.json index 048a4755..7e89ddb8 100644 --- a/UnityMcpBridge/package.json +++ b/UnityMcpBridge/package.json @@ -1,6 +1,6 @@ { "name": "com.coplaydev.unity-mcp", - "version": "2.1.1", + "version": "2.1.2", "displayName": "Unity MCP", "description": "A bridge that connects an LLM to Unity via the MCP (Model Context Protocol). This allows MCP Clients like Claude Desktop or Cursor to directly control your Unity Editor.", "unity": "2021.3", From 79389d832e815954189d0b6902a2cf0e011bfc1b Mon Sep 17 00:00:00 2001 From: Marcus Sanatan Date: Thu, 14 Aug 2025 18:48:24 -0400 Subject: [PATCH 4/7] feat: add workflow for version bumping --- .github/workflows/bump-version.yml | 107 +++++++++++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 .github/workflows/bump-version.yml diff --git a/.github/workflows/bump-version.yml b/.github/workflows/bump-version.yml new file mode 100644 index 00000000..fa4d42e0 --- /dev/null +++ b/.github/workflows/bump-version.yml @@ -0,0 +1,107 @@ +name: Bump Version + +on: + workflow_dispatch: + inputs: + version_bump: + description: "Version bump type" + type: choice + options: + - patch + - minor + - major + default: patch + required: true + +jobs: + bump: + name: "Bump version and tag" + runs-on: ubuntu-latest + permissions: + contents: write + steps: + - name: Checkout repository + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Compute new version + id: compute + shell: bash + run: | + set -euo pipefail + BUMP="${{ inputs.version_bump }}" + CURRENT_VERSION=$(jq -r '.version' "UnityMcpBridge/package.json") + echo "CURRENT_VERSION version: $CURRENT_VERSION" + + IFS='.' read -r MA MI PA <<< "$CURRENT_VERSION" + case "$BUMP" in + major) + ((MA+=1)); MI=0; PA=0 + ;; + minor) + ((MI+=1)); PA=0 + ;; + patch) + ((PA+=1)) + ;; + *) + echo "Unknown version_bump: $BUMP" >&2 + exit 1 + ;; + esac + + NEW_VERSION="$MA.$MI.$PA" + echo "New version: $NEW_VERSION" + echo "new_version=$NEW_VERSION" >> "$GITHUB_OUTPUT" + echo "current_version=$CURRENT_VERSION" >> "$GITHUB_OUTPUT" + + - name: Update files to new version + env: + NEW_VERSION: ${{ steps.compute.outputs.new_version }} + shell: bash + run: | + set -euo pipefail + + echo "Updating UnityMcpBridge/package.json to $NEW_VERSION" + jq ".version = \"${NEW_VERSION}\"" UnityMcpBridge/package.json > UnityMcpBridge/package.json.tmp + mv UnityMcpBridge/package.json.tmp UnityMcpBridge/package.json + + echo "Updating UnityMcpBridge/UnityMcpServer~/src/pyproject.toml to $NEW_VERSION" + sed -i '0,/^version = ".*"/s//version = "'"$NEW_VERSION"'"/' "UnityMcpBridge/UnityMcpServer~/src/pyproject.toml" + + - name: Commit and push changes + env: + NEW_VERSION: ${{ steps.compute.outputs.new_version }} + shell: bash + run: | + set -euo pipefail + git config user.name "GitHub Actions" + git config user.email "actions@github.com" + git add UnityMcpBridge/package.json "UnityMcpBridge/UnityMcpServer~/src/pyproject.toml" + if git diff --cached --quiet; then + echo "No version changes to commit." + else + git commit -m "chore: bump version to ${NEW_VERSION}" + fi + + BRANCH="${GITHUB_HEAD_REF:-${GITHUB_REF_NAME}}" + echo "Pushing to branch: $BRANCH" + git push origin "$BRANCH" + + - name: Create and push tag + env: + NEW_VERSION: ${{ steps.compute.outputs.new_version }} + shell: bash + run: | + set -euo pipefail + TAG="v${NEW_VERSION}" + echo "Preparing to create tag $TAG" + + if git ls-remote --tags origin | grep -q "refs/tags/$TAG$"; then + echo "Tag $TAG already exists on remote. Skipping tag creation." + exit 0 + fi + + git tag -a "$TAG" -m "Version ${NEW_VERSION}" + git push origin "$TAG" \ No newline at end of file From ce39ca6d49052de8ac3263a308596be3aee80838 Mon Sep 17 00:00:00 2001 From: Marcus Sanatan Date: Thu, 14 Aug 2025 18:48:39 -0400 Subject: [PATCH 5/7] Revert "Bump version because we have a name change" This reverts commit 148fa8b431ea7c4198030d48b7a3c0cfdf869258. We'll test the actions that bumps the version and tags the repo --- UnityMcpBridge/UnityMcpServer~/src/pyproject.toml | 2 +- UnityMcpBridge/package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml b/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml index 5ecb1035..2c05fb83 100644 --- a/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml +++ b/UnityMcpBridge/UnityMcpServer~/src/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "UnityMcpServer" -version = "2.1.2" +version = "2.0.0" description = "Unity MCP Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP)." readme = "README.md" requires-python = ">=3.10" diff --git a/UnityMcpBridge/package.json b/UnityMcpBridge/package.json index 7e89ddb8..048a4755 100644 --- a/UnityMcpBridge/package.json +++ b/UnityMcpBridge/package.json @@ -1,6 +1,6 @@ { "name": "com.coplaydev.unity-mcp", - "version": "2.1.2", + "version": "2.1.1", "displayName": "Unity MCP", "description": "A bridge that connects an LLM to Unity via the MCP (Model Context Protocol). This allows MCP Clients like Claude Desktop or Cursor to directly control your Unity Editor.", "unity": "2021.3", From a6e0eb669acb789a31d42616abfe9e3e99381705 Mon Sep 17 00:00:00 2001 From: Marcus Sanatan Date: Thu, 14 Aug 2025 19:00:29 -0400 Subject: [PATCH 6/7] Improve echo line Replaced a bit too aggressively lol --- .github/workflows/bump-version.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/bump-version.yml b/.github/workflows/bump-version.yml index fa4d42e0..87b38768 100644 --- a/.github/workflows/bump-version.yml +++ b/.github/workflows/bump-version.yml @@ -32,7 +32,7 @@ jobs: set -euo pipefail BUMP="${{ inputs.version_bump }}" CURRENT_VERSION=$(jq -r '.version' "UnityMcpBridge/package.json") - echo "CURRENT_VERSION version: $CURRENT_VERSION" + echo "Current version: $CURRENT_VERSION" IFS='.' read -r MA MI PA <<< "$CURRENT_VERSION" case "$BUMP" in @@ -104,4 +104,4 @@ jobs: fi git tag -a "$TAG" -m "Version ${NEW_VERSION}" - git push origin "$TAG" \ No newline at end of file + git push origin "$TAG" From ed63c245b3bdd3998aea53085361038ad5d81485 Mon Sep 17 00:00:00 2001 From: Marcus Sanatan Date: Thu, 14 Aug 2025 19:02:25 -0400 Subject: [PATCH 7/7] Improve README formatting --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c75888c8..d3c5c111 100644 --- a/README.md +++ b/README.md @@ -101,7 +101,7 @@ Unity MCP connects your tools using two components: ### 🌟Step 1: Install the Unity Package🌟 -### To install via Git URL +#### To install via Git URL 1. Open your Unity project. 2. Go to `Window > Package Manager`. @@ -113,7 +113,7 @@ Unity MCP connects your tools using two components: 5. Click `Add`. 6. The MCP Server should automatically be installed onto your machine as a result of this process. -### To install via OpenUPM +#### To install via OpenUPM 1. Instal the [OpenUPM CLI](https://openupm.com/docs/getting-started-cli.html) 2. Open a terminal (PowerShell, Terminal, etc.) and navigate to your Unity project directory