# UVCS MCP

UVCS MCP connects AI assistants to Plastic SCM and Unity Version Control via the cm CLI. Enables repository inspection, branch setup, and guarded checkins.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18 repo stars
- Author: ProAnima
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ProAnima/unity-version-control-mcp
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/uvcs-mcp

## What it does

The server exposes Plastic SCM, Unity Version Control, and Unity DevOps Version Control workspaces to AI agents via the `cm` command-line tool. It supports client versions 10.0.16.6656 and newer, including 11.x releases. Agents can review status diffs, inspect incoming changes, build branches, assign labels, and run merges without unrestricted terminal access.

It is not a Unity Editor automation bridge. The tool does not touch GameObjects, scenes, active Play Mode, or package windows; its scope remains strictly inside source control. The default operational profile is `readonly`. Modifications need standard mode and use a two-phase prepare-and-confirm sequence. During partial checkins, it automatically detects `.meta` companion files and stops if a meta file remains untracked.

The server fails immediately if Node.js is older than version 22 or if the local `cm` CLI is not authenticated.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `UVCS_WORKSPACE`, `UVCS_MCP_MODE`, `UVCS_ALLOWED_WORKSPACES`, `UVCS_ALLOWED_REPOS`, `UVCS_CM_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Unity

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env UVCS_WORKSPACE=<UVCS_WORKSPACE> --env UVCS_MCP_MODE=<UVCS_MCP_MODE> --env UVCS_ALLOWED_WORKSPACES=<UVCS_ALLOWED_WORKSPACES> --env UVCS_ALLOWED_REPOS=<UVCS_ALLOWED_REPOS> --env UVCS_CM_PATH=<UVCS_CM_PATH> --transport stdio uvcs-mcp -- npx -y @proanima/uvcs-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add uvcs-mcp --env UVCS_WORKSPACE=<UVCS_WORKSPACE> --env UVCS_MCP_MODE=<UVCS_MCP_MODE> --env UVCS_ALLOWED_WORKSPACES=<UVCS_ALLOWED_WORKSPACES> --env UVCS_ALLOWED_REPOS=<UVCS_ALLOWED_REPOS> --env UVCS_CM_PATH=<UVCS_CM_PATH> -- npx -y @proanima/uvcs-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "uvcs-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@proanima/uvcs-mcp"
            ],
            "env": {
                "UVCS_WORKSPACE": "<UVCS_WORKSPACE>",
                "UVCS_MCP_MODE": "<UVCS_MCP_MODE>",
                "UVCS_ALLOWED_WORKSPACES": "<UVCS_ALLOWED_WORKSPACES>",
                "UVCS_ALLOWED_REPOS": "<UVCS_ALLOWED_REPOS>",
                "UVCS_CM_PATH": "<UVCS_CM_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "uvcs-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@proanima/uvcs-mcp"
            ],
            "env": {
                "UVCS_WORKSPACE": "<UVCS_WORKSPACE>",
                "UVCS_MCP_MODE": "<UVCS_MCP_MODE>",
                "UVCS_ALLOWED_WORKSPACES": "<UVCS_ALLOWED_WORKSPACES>",
                "UVCS_ALLOWED_REPOS": "<UVCS_ALLOWED_REPOS>",
                "UVCS_CM_PATH": "<UVCS_CM_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e UVCS_WORKSPACE=<UVCS_WORKSPACE> -e UVCS_MCP_MODE=<UVCS_MCP_MODE> -e UVCS_ALLOWED_WORKSPACES=<UVCS_ALLOWED_WORKSPACES> -e UVCS_ALLOWED_REPOS=<UVCS_ALLOWED_REPOS> -e UVCS_CM_PATH=<UVCS_CM_PATH> uvcs-mcp npx -y @proanima/uvcs-mcp
```
Replace <…> with your own values

## When to use it
- inspect Plastic SCM workspace state and pending changes
- commit Unity assets while ensuring matching `.meta` files are included
- create branches and tags without granting arbitrary terminal execution
- preview incoming merges and abort when merge conflicts exist

## Example prompts
- Check the Unity Version Control workspace status and list pending changes
- Prepare a checkin for modified assets along with their corresponding meta files
- Run a merge preview from the target branch and check for unresolved conflicts

## Similar
- [unity-build-pipeline](https://affpapa.org/en/nevibecode/skills/unity-build-pipeline.md) — skill · 11100 installs
- [unity-package-management](https://affpapa.org/en/nevibecode/skills/unity-package-management.md) — skill · 9000 installs
- [optimize-web](https://affpapa.org/en/nevibecode/skills/optimize-web.md) — skill · 6600 installs
- [test-setup](https://affpapa.org/en/nevibecode/skills/test-setup.md) — skill · 633 installs
- [scenario-unity-pipeline-automation](https://affpapa.org/en/nevibecode/skills/scenario-unity-pipeline-automation.md) — skill · 567 installs
- [game-ci-cd-pipeline](https://affpapa.org/en/nevibecode/skills/game-ci-cd-pipeline.md) — skill · 297 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
