UVCS MCP - Unity Version Control / Plastic SCM MCP Server

Safe MCP server for Plastic SCM, Unity Version Control, and Unity DevOps Version Control source-control workspaces (cm 10.0.16.6656+, including 11.x).

UVCS MCP connects AI IDEs and coding agents to the local cm CLI through a fixed allowlist of documented SCM commands. It helps agents inspect source-control workspace state, prepare changes, create branches and labels, run guarded checkins, and perform merges without arbitrary shell access.

Current release: 1.0.0. Supported cm clients: 10.0.16.6656 and newer. Validated end-to-end on Plastic SCM 10.x and Unity Version Control / Unity DevOps Version Control 11.x.

Not a Unity Editor MCP

UVCS MCP is not a Unity Editor automation server. It does not control scenes, GameObjects, Play Mode, Unity packages, editor windows, builds, or runtime objects.

It works with the Plastic SCM / Unity Version Control cm CLI and focuses on source-control workflows: status, pending changes, branches, labels, checkins, locks, diffs, and merges.

Quick Install

Ask your AI IDE to install this MCP server from the GitHub repository URL.

For example:

Install this MCP server from https://github.com/ProAnima/unity-version-control-mcp, configure it for my Plastic SCM / Unity Version Control source-control workspace, and run uvcs_doctor.

Or install manually:

git clone https://github.com/ProAnima/unity-version-control-mcp.git uvcs-mcp
cd uvcs-mcp
node src/cli.js init-local --client=cursor,codex,claude-code,opencode,antigravity,kiro --workspace="D:/Repositories/YourWorkspace"

Restart your MCP client, then ask it to run:

uvcs_doctor
uvcs_workspace_status

Preview config changes without writing:

node src/cli.js init-local --client=all --workspace="D:/Repositories/YourWorkspace" --print-config

Manual Setup By OS

Windows:

node src/cli.js init-local --client=cursor,codex,claude-code,opencode,antigravity,kiro,windsurf --workspace="D:\Repositories\YourWorkspace"

macOS:

node src/cli.js init-local --client=cursor,codex,claude-code,opencode,antigravity,kiro,windsurf --workspace="$HOME/Repositories/YourWorkspace"

Linux:

node src/cli.js init-local --client=cursor,codex,claude-code,opencode,antigravity,kiro,windsurf --workspace="$HOME/Repositories/YourWorkspace"

If cm is not in PATH, add --cm=/path/to/cm or set UVCS_CM_PATH.

Quick Start From npm

npx -y @proanima/uvcs-mcp init --client=cursor,codex --workspace="D:/Repositories/YourWorkspace"

Manual MCP block:

{
  "command": "npx",
  "args": ["-y", "@proanima/uvcs-mcp"],
  "env": {
    "UVCS_WORKSPACE": "D:/Repositories/YourWorkspace",
    "UVCS_MCP_MODE": "readonly"
  }
}

Supported Clients

• Cursor
• Cursor global
• Codex
• Claude Desktop
• Claude Code
• OpenCode
• OpenCode global
• Antigravity
• Kiro
• Kiro global
• Windsurf

Safety Model

• Default mode is readonly.
• Protocol handling is provided by the official MCP TypeScript SDK.
• Tool input is validated server-side with strict schemas.
• Write tools require UVCS_MCP_MODE=standard.
• Critical write operations use *_prepare followed by matching *_confirm.
• Write confirmations are serialized per workspace.
• Repository delete, repository rename, arbitrary cm, arbitrary shell execution, and raw cm api startup are not exposed.
• Optional JSONL audit logging is available with UVCS_AUDIT_LOG=/path/to/uvcs-mcp-audit.jsonl.

Tools

• uvcs_doctor
• uvcs_workspace_status
• uvcs_pending_changes
• uvcs_branch_info
• uvcs_locks
• uvcs_unity_meta_diagnostics
• uvcs_style_rules
• uvcs_style_setup_check
• uvcs_style_init_prepare / uvcs_style_init_confirm
• uvcs_name_preview
• uvcs_release_plan
• uvcs_diff_file
• uvcs_cleanup_candidates
• uvcs_branch_safety_report
• uvcs_update_workspace_prepare / uvcs_update_workspace_confirm
• uvcs_changeset_analytics
• uvcs_add_prepare / uvcs_add_confirm
• uvcs_branch_create_prepare / uvcs_branch_create_confirm
• uvcs_label_create_prepare / uvcs_label_create_confirm
• uvcs_switch_workspace_prepare / uvcs_switch_workspace_confirm
• uvcs_merge_prepare / uvcs_merge_confirm
• uvcs_checkin_prepare / uvcs_checkin_confirm

Development

npm test
npm run check
npm run smoke:fake

Run the real Plastic SCM smoke test against a disposable or safe workspace:

npm run smoke:plastic -- "D:/Repositories/YourWorkspace"

The smoke test creates temporary branches, labels, checkins, and a merge through MCP tools.

Project Support

• Use GitHub Issues for reproducible bugs, client setup problems, and compatibility reports.
• Use feature requests for new SCM workflows or MCP tools.
• Do not include secrets, access tokens, private server credentials, or full proprietary logs in public issues.
• For security reports, see Security Policy.

Documentation

• Install
• Clients
• Security
• Security Review
• Compatibility
• Publishing
• Automation Style
• Production Readiness
• Troubleshooting
• Rules for Agents
• Contributing
• Support
• Wiki Source
• Changelog

Maintainer

Ian Panaev, ProAnimaStudio, 2026. Contact: [email protected].