# UVCS MCP

> UVCS MCP is an open-source MCP server for developer tools. Guarded Plastic SCM and Unity Version Control tools for coding agents, via the cm CLI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Repository:** https://github.com/proanima/unity-version-control-mcp
- **MCP Registry name:** io.github.ProAnima/uvcs-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

UVCS MCP connects coding agents to the local cm command line for Plastic SCM and Unity Version Control workspaces (cm 10.0.16.6656 and newer, including 11.x). It is explicitly not a Unity Editor automation server: it handles source-control work such as status, pending changes, branches, labels, checkins, locks, diffs and merges, not scenes or builds.

Safety is the main design point. The default mode is readonly. Writes need standard mode and follow a prepare-then-confirm pattern, with MCP annotations so clients can auto-approve reads and ask before every confirm tool. Merges that the preview reports as conflicting are refused at both steps, path-scoped checkins add the .meta file of each selected Unity asset, option-like names and wildcard paths are rejected, and cm runs without a shell. Repository delete, arbitrary cm and arbitrary shell commands are not exposed. An allowlist can pin the workspace and repository identity, and optional JSONL audit logging is available.

An init command writes config for Cursor, Codex, Claude Desktop, Claude Code, OpenCode, Antigravity, Kiro, Windsurf and Zed, and a doctor command validates the result. Node.js 22 or newer is required.

## Features

- **Readonly by default:** Inspection only unless standard mode is enabled.
- **Prepare and confirm writes:** Every write has a prepare step and a matching confirm step.
- **Merge preview:** Conflicting merges are refused before they start.
- **Unity-aware checkins:** Selected assets bring their .meta partners; assets with private .meta are refused.
- **Workspace pinning:** Allowlists restrict workspaces and repository identities.
- **Audit log:** Optional JSONL record of actions.

## Good for

- Review pending changes and file history before a checkin
- Preview a merge for conflicts
- Let an agent create branches and labels with approval
- Check locks on shared assets
- Audit what an agent did in a workspace

## Install

### Claude Code (Terminal)

```sh
claude mcp add uvcs-mcp --env UVCS_WORKSPACE='<UVCS_WORKSPACE>' -- npx -y @proanima/uvcs-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "uvcs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@proanima/uvcs-mcp"
      ],
      "env": {
        "UVCS_WORKSPACE": "<UVCS_WORKSPACE>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "uvcs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@proanima/uvcs-mcp"
      ],
      "env": {
        "UVCS_WORKSPACE": "<UVCS_WORKSPACE>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "uvcs-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@proanima/uvcs-mcp"
      ],
      "env": {
        "UVCS_WORKSPACE": "<UVCS_WORKSPACE>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "uvcs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@proanima/uvcs-mcp"
      ],
      "env": {
        "UVCS_WORKSPACE": "<UVCS_WORKSPACE>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "uvcs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@proanima/uvcs-mcp"
      ],
      "env": {
        "UVCS_WORKSPACE": "<UVCS_WORKSPACE>"
      }
    }
  }
}
```

## Tools

- `uvcs_doctor`: Diagnoses setup
- `uvcs_policy_status`: Shows the active safety policy
- `uvcs_setup_status`: Shows setup state
- `uvcs_workspace_status`: Shows workspace state
- `uvcs_pending_changes`: Lists pending changes
- `uvcs_branch_info`: Shows branch information
- `uvcs_locks`: Lists locks
- `uvcs_checkout_prepare`: Prepares a checkout
- `uvcs_checkout_confirm`: Confirms a checkout
- `uvcs_release_checkout_prepare`: Prepares releasing a checkout
- `uvcs_release_checkout_confirm`: Confirms releasing a checkout
- `uvcs_unity_meta_diagnostics`: Diagnoses Unity .meta files
- `uvcs_style_rules`: Shows style rules
- `uvcs_style_setup_check`: Checks style setup
- `uvcs_style_init_prepare`: Prepares style initialisation
- `uvcs_style_init_confirm`: Confirms style initialisation
- `uvcs_name_preview`: Previews names
- `uvcs_release_plan`: Plans a release
- `uvcs_diff_file`: Diffs a file
- `uvcs_changeset_diff`: Diffs a changeset
- `uvcs_revision_diff`: Diffs revisions
- `uvcs_file_history`: Shows file history
- `uvcs_annotate`: Annotates a file
- `uvcs_branch_list`: Lists branches
- `uvcs_label_list`: Lists labels
- `uvcs_merge_preview`: Previews a merge
- `uvcs_cleanup_candidates`: Finds cleanup candidates
- `uvcs_branch_safety_report`: Reports branch safety
- `uvcs_update_workspace_prepare`: Prepares a workspace update
- `uvcs_update_workspace_confirm`: Confirms a workspace update
- `uvcs_changeset_analytics`: Analyses changesets

## FAQ

### Does it control the Unity Editor?

No, it only works with source control through the cm CLI.

### Which cm versions work?

10.0.16.6656 and newer, including 11.x.

### Can an agent run arbitrary shell commands?

No. cm runs from a fixed allowlist without a shell.

### How do I allow writes?

Set UVCS_MCP_MODE to standard; the default is readonly.

### Is UVCS MCP free?

Yes. UVCS MCP is open source, so you can use and self-host it for free.

### How do I add UVCS MCP to Claude Code?

Run this command in your terminal: claude mcp add uvcs-mcp --env UVCS_WORKSPACE='<UVCS_WORKSPACE>' -- npx -y @proanima/uvcs-mcp

### What are the best alternatives to UVCS MCP?

The closest alternatives to UVCS MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/uvcs-mcp
