Skip to content
MCP server

UVCS MCP

Guarded Plastic SCM and Unity Version Control tools for coding agents, via the cm CLI

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, macOS
Runs
Locally
Version
1.4.1
Listing updated
2 days ago

About UVCS MCP

UVCS MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • UVCS_WORKSPACEAbsolute path of the Plastic SCM / Unity Version Control workspace (the folder that contains .plastic).Required
  • UVCS_MCP_MODEreadonly (default) for inspection only; standard enables prepare/confirm write tools.
  • UVCS_ALLOWED_WORKSPACESWorkspace paths the server may use, separated by ';'. Set it to UVCS_WORKSPACE to pin the workspace.
  • UVCS_ALLOWED_REPOSrepository@server:port identities the workspace must match, separated by ';' (the guarded profile).
  • UVCS_CM_PATHAbsolute path of the cm executable when it is not on PATH (GUI clients on macOS often need it).

Tools this server provides (31)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free npm package

UVCS MCP 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 to UVCS MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools